Metadata-Version: 2.4
Name: fluxbit-mcp
Version: 0.1.0
Summary: Connect your own AI agent to FluxBit — the game-art studio your agent runs. Thin MCP (Model Context Protocol) stdio client.
Author: FluxBit
License-Expression: MIT
Project-URL: Homepage, https://fluxbit.app
Keywords: mcp,model-context-protocol,fluxbit,ai-agent,game-art,claude,claude-code
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: Topic :: Multimedia :: Graphics
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp>=1.2
Dynamic: license-file

# fluxbit-mcp

Connect your own AI agent to **[FluxBit](https://fluxbit.app)** — the game-art studio your agent runs.

This is a thin [Model Context Protocol](https://modelcontextprotocol.io) (MCP) **stdio** client. It exposes your
FluxBit projects to your own agent (Claude Code, or any MCP client) as tools: list projects, inspect a project's
asset catalog and house art-bible, generate concept art / 3D / audio on FluxBit's GPUs, and *propose* a publish
(a human approves the irreversible step). Your agent is the brain; FluxBit is the hands.

It holds **no model credentials** — it authenticates to FluxBit with a per-user Bearer token you mint in the app,
and every write / paid / publish action stays gated server-side by FluxBit (RBAC, per-project scope, spend caps,
moderation, and human-in-the-loop publish).

## Connect (no install, no clone)

In FluxBit, open **Connect an agent** → set a spend cap → mint a token. Then run one command:

```sh
claude mcp add fluxbit \
  --env FLUXBIT_URL=https://fluxbit.app \
  --env FLUXBIT_TOKEN=<your-token> \
  -- uvx fluxbit-mcp
```

`uvx` (from [uv](https://docs.astral.sh/uv/)) fetches and runs this package on demand — nothing to install or keep
updated. Then just talk to your agent: *"Generate three hero-ship concepts for my game, then show me the strongest one."*

## Configuration

| Env var | Default | Meaning |
|---|---|---|
| `FLUXBIT_URL` | `http://127.0.0.1:8770` | Your FluxBit instance base URL |
| `FLUXBIT_TOKEN` | — | The Bearer token you minted in **Connect an agent** |

## License

MIT.
