io.github.ANAMIZED/needrail

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.

Option	Amount	Link
Public Goods Support	$25	Donate
Monthly Sponsor	$25/mo	Sponsor
Kernel Support	$99	Donate

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