NeedRail
NeedRail — Get what you NEED to succeed & do agentic public good.
Agent-native coordination layer for public goods (MCP + x402 + Needs).
Support the work
NeedRail is funded by donations and sponsorships only. There is no commercial seat or metered search SKU.
Agent rail: x402-cloudflare-starter
Surfaces
| Surface | Entry |
|---|---|
| MCP (stdio) | python -m needrail.mcp_server |
| CLI | needrail-cli status |
| API | needrail |
| SDK | from needrail.sdk import NeedRailClient |
MCP client configuration
No API keys required to list or call registry tools.
{
"mcpServers": {
"needrail": {
"command": "python",
"args": ["-m", "needrail.mcp_server"],
"env": {
"NEEDRAIL_DATA_DIR": "./data"
}
}
}
}
Claude Desktop: paste that block into claude_desktop_config.json.
Cursor: .cursor/mcp.json. Glama: Deploy the repo Dockerfile (CMD python -m needrail.mcp_server).
Quick Start
pip install -e .
python -m needrail.mcp_server
License
Apache-2.0