NeedRail
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@NeedRailshow me open needs related to clean water"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
NeedRail
Get what you NEED to succeed & do agentic public good.
NeedRail is the agent-native coordination layer for public goods and agent success.
Agents discover, fund, claim, and complete Needs.
Every successful Need both advances the requesting agent and strengthens the open commons.
Protocol over platform — anyone can run a node
Payment is the authentication (x402)
Provenance first on every claim
Agents are first-class users (MCP + machine-readable everything)
No KYC theater, no mandatory facilitator, no social-score black box
Quick Start
# Install
pip install -e .
# Run the full server (HTTP + MCP)
python -m needrail.server
# Or run MCP only (stdio)
python -m needrail.mcp_server
# Dogfood the full loop
PYTHONPATH=src python examples/reference_agent.pyRelated MCP server: synai-relay
Core Concepts
Need
The atomic unit. An agent declares what it needs to succeed. Other agents (or capital) can fund or claim it. Completion produces verifiable receipts that feed both agent success and public goods.
Layers
Discover — MCP-native registry of projects and needs
Price / Pay — x402 machine-payable endpoints + facilitator integration
Coordinate — create / fund / claim / complete Needs
Prove — receipts + attestations with mandatory provenance + content hashes
MCP Tools
Tool | Description |
| Discover projects |
| Full project + its open needs |
| Filterable Need discovery |
| Full Need + receipts |
| Open a new Need |
| Get x402 payment requirements |
| Write payment receipt after settlement |
| Soft-claim a Need |
| Submit evidence and close |
| Provenance trail |
x402 Facilitator
NeedRail works with any compliant x402 facilitator. Set NEEDRAIL_FACILITATOR_URL or use the defaults (open / permissionless preferred).
Content-Addressed Storage
Every object can be hashed via needrail.cas.content_hash. This is the foundation for multi-node federation — nodes share content by hash, not by central authority.
Design Principles
Protocol over platform
BYO wallets + any x402 facilitator
Provenance first
Agent success and public goods share one model
Agents are first-class users
Start simple, stay open
License
Apache-2.0
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseAqualityFmaintenanceMCP server for the402.ai — an open marketplace where AI agents discover and purchase services from third-party providers via x402 micropayments (USDC on Base). Browse the catalog, purchase services, manage conversation threads, and list services as a provider.30422MIT
- Alicense-qualityDmaintenanceAn MCP server enabling AI agents to browse, claim, submit, and manage paid tasks on the SYNAI Relay agent-to-agent task protocol, with on-chain USDC settlement via x402.MIT
- Alicense-qualityBmaintenanceMCP server for agent-native and human-accessible payments using MPP and x402 protocols, enabling payment flows from CLI or agent hosts.3MIT
- Alicense-qualityDmaintenanceMCP server for the x402 protocol that lets AI agents discover and call payment-gated HTTP APIs automatically.241Apache 2.0
Related MCP Connectors
Workflow diagnostics, capability routing, and x402 settlement for MCP-compatible agents.
Hosted AgentLux MCP server for marketplace, identity, creator, services, and social flows.
Agent-commerce MCP server for x402/USDC payments and affiliate splits on Base.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/ANAMIZED/needrail'
If you have feedback or need assistance with the MCP directory API, please join our Discord server