Metadata-Version: 2.4
Name: zero-network-mcp
Version: 0.1.1
Summary: MCP server for the Zero Network — lets AI agents understand, integrate, and transact on Zero
Project-URL: Homepage, https://mcp.zzero.net
Project-URL: Documentation, https://docs.zzero.net
Project-URL: Repository, https://github.com/Zzero-net/mcp-server
Author-email: Zero Network <dev@zzero.net>
License-Expression: MIT
Keywords: ai-agents,mcp,micropayments,stablecoin,zero
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.10
Requires-Dist: mcp[cli]>=1.0.0
Description-Content-Type: text/markdown

# Zero Network MCP Server

An MCP server that gives AI agents instant access to Zero Network documentation, integration guides, and utility tools.

## Tools (14)

### Documentation
| Tool | Description |
|------|-------------|
| `zero_overview` | Network overview — what Zero is, core facts, architecture, links |
| `zero_transaction_format` | 100-byte wire format, 48-byte account state, crypto primitives |
| `zero_python_sdk` | Python SDK — install, wallet, send, bridge, env vars |
| `zero_javascript_sdk` | JavaScript SDK — install, wallet, send, env vars |
| `zero_x402_integration` | x402 HTTP payment protocol — server middleware, client auto-pay |
| `zero_mcp_payments` | MCP payment integration — charge per tool call, spending limits |
| `zero_api_reference` | All 8 gRPC endpoints |
| `zero_network_parameters` | Full parameter table — fees, limits, staking, slashing |
| `zero_validator_info` | Validator setup, hardware, staking, economics |
| `zero_security_model` | Security architecture, Trinity Validators, attack mitigations |
| `zero_implementation_guide` | Step-by-step: API paywall, MCP pricing, website paywall |

### Utilities
| Tool | Description |
|------|-------------|
| `zero_convert` | Convert between USD, Z, and units |
| `zero_estimate_cost` | Estimate transaction costs with competitor comparison |
| `zero_pricing_calculator` | Calculate revenue for a Zero-gated service |

## Usage

### Claude Code / Claude Desktop
Add to your MCP config:
```json
{
  "mcpServers": {
    "zero": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/mcp-server", "python", "-m", "zero_mcp.server"]
    }
  }
}
```

### Direct
```bash
cd mcp-server
uv venv && uv pip install "mcp[cli]>=1.0.0"
source .venv/bin/activate
python -m zero_mcp.server
```

## What Agents Can Do

An AI agent connected to this MCP server can:
1. Learn what Zero is and how it works
2. Get SDK code examples for Python or JavaScript
3. Implement x402 paywalls on their APIs
4. Add per-tool pricing to their MCP servers
5. Convert between USD/Z/units
6. Estimate costs for any transaction volume
7. Calculate revenue projections for paid services
