Enables AI agents to perform cross-protocol payments for services using USDC or Lightning via a universal payment router.
Also known as cinderwright-ai/cinderwright-api, cinderwright-mcp-server
- Stars
- 4
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.1.1
- Last commit
- Aug 30, 2026
- License
- MIT
What is Cinderwright MCP?
Cinderwright enables AI agents to perform cross-protocol payments for services using USDC or Lightning via a universal payment router.
Summary generated from the project's README
About Cinderwright MCP server
Cinderwright acts as a universal payment router designed for AI agents that need to access paid services across different protocols. It allows an agent holding a USDC balance on Base to interact with thousands of indexed services, including those requiring Lightning Network payments. The system automatically detects the necessary payment protocol from response headers and handles the routing, so the agent does not need to manage multiple wallets or sign individual transactions.
Developers can integrate this functionality into Claude Desktop using the cinderwright-mcp-server via npx. The server provides 17 tools, such as proxy_do for executing tasks, proxy_setup for account initialization, and proxy_balance for checking funds. Users must provide a CW_KEY in their configuration to authenticate. The platform currently supports 1,503 x402 services and 1,185 L402 services, with MPP support planned for the future.
What you can do with it
- 1Execute cross-protocol service tasksAn AI agent can perform a task like checking the weather by sending a plain-English request through the proxy.
- 2Automate Lightning payments with USDCAn agent can pay for L402 services automatically using its existing USDC balance.
- 3Discover available paid servicesUsers can search through thousands of indexed services to find specific capabilities.
Written from the project's README. Every use case is checked against a quote from it.
How to install Cinderwright MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Cinderwright MCP in Claude Code
$ claude mcp add cinderwright-api -- npx -y cinderwright-mcp-serverInstall Cinderwright MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"cinderwright-api": {
"command": "npx",
"args": [
"-y",
"cinderwright-mcp-server"
]
}
}
}Install Cinderwright MCP in VS Code
.vscode/mcp.json
{
"servers": {
"cinderwright-api": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"cinderwright-mcp-server"
]
}
}
}Install Cinderwright MCP in VS Code CLI
$ code --add-mcp '{"name":"cinderwright-api","type":"stdio","command":"npx","args":["-y","cinderwright-mcp-server"]}'Install Cinderwright MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"cinderwright-api": {
"command": "npx",
"args": [
"-y",
"cinderwright-mcp-server"
]
}
}
}Install Cinderwright MCP in Codex
$ codex mcp add cinderwright-api -- npx -y cinderwright-mcp-serverInstall Cinderwright MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.cinderwright-api] command = "npx" args = ["-y", "cinderwright-mcp-server"]
Install Cinderwright MCP in Gemini CLI
$ gemini mcp add -s user cinderwright-api npx -- -y cinderwright-mcp-serverInstall Cinderwright MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"cinderwright-api": {
"command": "npx",
"args": [
"-y",
"cinderwright-mcp-server"
]
}
}
}Configuration
CW_KEY
| Name | Description | |
|---|---|---|
| CW_KEY | — |
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablecinderwright-ai/cinderwright-api is public and reachablegithub.com/cinderwright-ai/cinderwright-api ↗Pass
- Package names this repository as its sourcecinderwright-mcp-server names cinderwright-ai/cinderwright-api as sourcenpmjs.com/package/cinderwright-mcp-server ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-08-30github.com/cinderwright-ai/cinderwright-api ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from cinderwright-mcp-serverPass
- No critical advisory in the package or its dependencies99 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubWhat shipped this week
June 9, 2026: Both bridge directions confirmed on mainnet.
- Lightning --> USDC proxy: pay a Lightning invoice, get agent credit within 30 seconds
- USDC --> Lightning: agent with USDC pays L402 services automatically
- Free demo: api.ideafactorylab.org -- no account needed
- CLI:
npx cinderwright "Bitcoin price" - 2,835 services indexed. $0.10 free credit on new accounts.
Cinderwright — Universal Payment Router for AI Agents
x402 + L402 (Lightning) interoperable. First confirmed cross-protocol agent payment June 2026.
An AI agent with a USDC balance can now call any Lightning-gated (L402) service. We detect the protocol, route the payment, and return the data. The agent never knows which protocol settled.
# One endpoint. Any protocol. 2,811 services.
curl -X POST https://api.ideafactorylab.org/proxy/do \
-H "X-CW-Key: sk_cw_your_key" \
-d '{"task": "get weather in Tokyo"}'
What's Live
| Protocol | Services | Status |
|---|---|---|
| x402 (USDC on Base) | 1,503 | Live |
| L402 (Bitcoin Lightning) | 1,185 | Live |
| MPP (Stripe/Tempo) | 92 | Coming soon |
Lightning status: https://api.ideafactorylab.org/lightning-status
How It Works
- Agent deposits USDC to their proxy account
- Agent sends a plain-English task to
/proxy/do - Cinderwright searches 2,811 services, finds the best match
- Detects the payment protocol from the 402 response headers
- Routes payment accordingly: USDC for x402, Lightning invoice for L402
- Returns the data, charges USDC equivalent from agent's balance
The agent never manages wallets, signs transactions, or knows which protocol ran.
Quick Start
# Get a proxy account
curl -X POST https://api.ideafactorylab.org/proxy/setup \
-d '{"wallet": "0xYourBaseWallet"}'
# Deposit USDC on Base to the returned address
# Call any service
curl -X POST https://api.ideafactorylab.org/proxy/do \
-H "X-CW-Key: sk_cw_your_key" \
-d '{"task": "Bitcoin price now", "max_cost_usd": 0.10}'
MCP Server for Claude Desktop
npx cinderwright-mcp-server
Add to claude_desktop_config.json:
{
"mcpServers": {
"cinderwright": {
"command": "npx",
"args": ["-y", "cinderwright-mcp-server"],
"env": { "CW_KEY": "sk_cw_your_key_here" }
}
}
}
17 tools including proxy_do, proxy_setup, proxy_balance, and service discovery.
Free Developer Tools
| Tool | What it does |
|---|---|
| /test | Live service tester |
| /debug | 16-check diagnostic engine with host pollution + scheme detection |
| /sandbox | Test EIP-3009 signing without spending USDC |
| /budget | Per-call caps and kill switch |
| /setup | Wallet setup wizard |
| /lightning-status | Lightning node status and outbound capacity |
| /onchain | On-chain settlement data via TomSmart mapper.db |
Discovery
# Free search
curl "https://api.ideafactorylab.org/discover?q=weather"
curl "https://api.ideafactorylab.org/discover?q=bitcoin+price&protocol=l402"
# On-chain settlement data for any service
curl "https://api.ideafactorylab.org/onchain?endpoint=https://your-service.com/api"
# Submit your service
curl -X POST https://api.ideafactorylab.org/submit \
-d '{"url": "https://your-service.com"}'
Architecture
The universal payment router sits between agents and services:
Agent (USDC balance)
|
v
POST /proxy/do {"task": "..."}
|
v
Cinderwright Router
|-- detect protocol from 402 response headers
|-- x402: sign USDC payment via EIP-3009
|-- L402: pay Lightning invoice via LND REST
|-- MPP: (coming soon)
|
v
Service returns data
|
v
Agent receives data + charged USDC equivalent
Links
- Hub: https://api.ideafactorylab.org
- Lightning status: https://api.ideafactorylab.org/lightning-status
- npm:
npx cinderwright-mcp-server - Twitter/X: @Cinderwright
Cinderwright MCP questions
How do I add Cinderwright MCP to Claude Code?
Run claude mcp add cinderwright-api -- npx -y cinderwright-mcp-server in your terminal. Add --scope user to make it available in every project.
How do I add Cinderwright MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How can an agent pay for Lightning-gated services?
An agent with a USDC balance can call any Lightning-gated (L402) service; the router detects the protocol and routes the payment automatically.
Does the agent need to manage crypto wallets?
No, the agent does not need to manage wallets, sign transactions, or know which protocol was used for settlement.
Is there a way to test the service without spending money?
Yes, you can use the sandbox tool to test EIP-3009 signing without spending USDC.
What tools are available in the MCP server?
The MCP server includes 17 tools such as proxy_do, proxy_setup, proxy_balance, and service discovery.