Metadata-Version: 2.4
Name: silvanexum-mcp
Version: 0.1.1
Summary: Model Context Protocol server for Silvanexum — the spend-control plane for AI agents. Discover, run, and inspect agents with signed, credit-metered runs and live org spend, from any MCP host. Run with `uvx silvanexum-mcp`.
Project-URL: Homepage, https://docs.silvanexum.com
Project-URL: Repository, https://github.com/silvanexum/Silvanexum-sdk
Author: Silvanexum
License-Expression: Apache-2.0
Keywords: agents,ai,claude,cost,finops,mcp,model-context-protocol,silvanexum,spend
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.10
Requires-Dist: mcp<2,>=1.2
Requires-Dist: silvanexum<1,>=0.1
Description-Content-Type: text/markdown

# silvanexum-mcp

<!-- mcp-name: io.github.silvanexum/silvanexum -->

The official [Model Context Protocol](https://modelcontextprotocol.io) server for
[Silvanexum](https://silvanexum.com), for Python hosts — **the spend-control plane
for AI agents**. Discover, run, and inspect agents with signed, replayable,
credit-metered runs and live org spend, from any MCP host.

> The Node build is [`@silvanexum/mcp`](https://www.npmjs.com/package/@silvanexum/mcp)
> (`npx -y @silvanexum/mcp`). This is the `uvx` equivalent. Full budgets, caps,
> and cost attribution live in the [`silvanexum`](https://pypi.org/project/silvanexum/) SDK.

## Run it

```bash
export SILVANEXUM_API_KEY="sx_live_..."   # read+run scopes; never pay
uvx silvanexum-mcp
```

### Claude Desktop / Claude Code

```jsonc
{
  "mcpServers": {
    "silvanexum": {
      "command": "uvx",
      "args": ["silvanexum-mcp"],
      "env": { "SILVANEXUM_API_KEY": "sx_live_..." }
    }
  }
}
```

## Tools

`search_agents` · `get_agent` · `get_reputation` · `run_agent` (→ answer + signed
replay URL) · `get_run` · `deploy_template` · `wallet_balance`.

## Configuration

| Env var | Purpose |
| --- | --- |
| `SILVANEXUM_API_KEY` | **Required.** Scoped key (`read`+`run` recommended). |
| `SILVANEXUM_BASE_URL` | API base (default `https://api.silvanexum.com`). |
| `SILVANEXUM_WEB_URL` | Web base for replay URLs (default `https://silvanexum.com`). |

Licensed Apache-2.0.
