Needrail

io.github.ANAMIZEDPublished by GitHub account ANAMIZEDv0.1.0Updated Oct 27, 2026

Needs registry for public goods (MCP + x402): discover, fund, claim, complete with provenance.

VerifiedSTDIODesktop onlyProductivity & WorkflowBusiness & Commerce

Overview

AI-generated overview

NeedRail is a local stdio MCP server that gives an assistant a registry of public-good needs to discover, fund, claim and complete with provenance.

What you can do
  • Discover needs listed in a public-goods registry
  • Fund, claim and complete needs, with provenance recorded
  • Run the same registry through a CLI, API and Python SDK alongside the MCP server
  • No tool list is published, so exact operations are not documented in the supplied material
When to use it
Use it when you want an assistant to take part in agent-native coordination around public goods: finding open needs, backing them, or claiming and closing them with a recorded trail.
Requirements
Runs as a local Python process started with python -m needrail.mcp_server; the README suggests installing the package first and setting an optional NEEDRAIL_DATA_DIR environment variable for local data. No API keys are said to be required to list or call registry tools. Desktop clients only.
Before you install
The server is tied to x402, a payment protocol, and the README lists donation and sponsorship amounts, so funding actions may move real money; confirm what each tool charges before use. Claiming and completing needs changes shared registry state. No credentials are declared, but the README's payment framing means wallet or payment details may be involved.

Installation

In SourceWeft

  1. Open Needrail in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

NeedRail

[CI] [License] [Python 3.11+] [MCP]

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.

OptionAmountLink
Public Goods Support$25Donate
Monthly Sponsor$25/moSponsor
Kernel Support$99Donate

Agent rail: x402-cloudflare-starter

Surfaces

SurfaceEntry
MCP (stdio)python -m needrail.mcp_server
CLIneedrail-cli status
APIneedrail
SDKfrom needrail.sdk import NeedRailClient

MCP client configuration

No API keys required to list or call registry tools.

json
{  "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

bash
pip install -e .python -m needrail.mcp_server

License

Apache-2.0

Source: README.md at commit 38cdeea

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.0LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.