Metadata-Version: 2.4
Name: stackapps-suite-mcp
Version: 0.1.5
Summary: MCP gateway for the StackApps tool suite — pay per call in USDC via x402, no account required
Project-URL: Homepage, https://stackapps.app
Project-URL: Source, https://github.com/Explorer-64/StackApps
Project-URL: Blueprint, https://mcp.stackapps.app/blueprint.txt
Author: Abe Reimer
License: MIT
Keywords: agent-payments,mcp,pwa-icons,stackapps,usdc,x402
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.11
Requires-Dist: eth-account>=0.13.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.27.1
Requires-Dist: uvicorn>=0.30.0
Requires-Dist: x402[clients,evm]>=2.0.0
Description-Content-Type: text/markdown

# stackapps-suite-mcp

mcp-name: io.github.explorer-64/stackapps-suite-mcp

One MCP server for the whole [StackApps](https://stackapps.app) tool suite.
Pay per call in USDC on Base mainnet via [x402](https://www.x402.org/) — no
account, no API key, no signup. Each member app (Imagcon today; more as they
ship) contributes tools; one install covers the suite.

## Install

```bash
claude mcp add stackapps-suite -- uvx stackapps-suite-mcp --wallet-key 0x...
```

Or in any MCP client config (Claude Desktop, Cursor, Windsurf, Cline):

```json
{
  "mcpServers": {
    "stackapps-suite": {
      "command": "uvx",
      "args": ["stackapps-suite-mcp"],
      "env": { "WALLET_PRIVATE_KEY": "0x..." }
    }
  }
}
```

Requirements: [uv](https://docs.astral.sh/uv/), Python 3.11+, an EVM wallet
holding USDC on Base mainnet (eip155:8453). Prefer the `WALLET_PRIVATE_KEY`
env var over the `--wallet-key` argument.

## Tools

| Tool | Price (USDC) | What it does |
|---|---|---|
| `create_pwa_icons_from_image` | $0.10 | Full PWA icon set (27 files + manifest.json) from a local image |
| `create_splash_screens_from_image` | $0.10 | 16 iOS/iPad splash screens from a local image |
| `generate_pwa_icons` | $0.295 | AI-generated PWA icon set from a text description |
| `generate_image` | $0.195 | AI-generated source image (returns preview URL) |
| `generate_splash_screens` | $0.295 | AI-generated splash screens from a text description |
| `get_wallet_profile` | free | Check your wallet's Imagcon profile status |
| `setup_wallet_profile` | free | Activate a permanent account (wallet-signature verified) |

## Payment safety

The server refuses to sign any payment challenge that does not pay the
StackApps suite wallet, or that exceeds the per-call cap ($0.50 USDC by
default; override with `STACKAPPS_MAX_USD_PER_CALL`). A compromised or spoofed
endpoint cannot redirect or inflate payments. Payments settle on-chain via
EIP-3009 — the gas is sponsored; your wallet needs only USDC.

Never commit your wallet key, and never run this server on a public host with
`WALLET_PRIVATE_KEY` set. The hosted endpoint at
[mcp.stackapps.app](https://mcp.stackapps.app/blueprint.txt) serves discovery
metadata only.

## Discovery

Machine-readable capability contract (Blueprint Protocol):
[mcp.stackapps.app/blueprint.txt](https://mcp.stackapps.app/blueprint.txt)

## Links

- Suite: https://stackapps.app
- Source: https://github.com/Explorer-64/StackApps (`stackapps-mcp/`)
- Imagcon (current member app): https://imagcon.app
