Meta Agent Tools
PT

Back to the catalog

io.github.ANAMIZED/needrail

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

Open source Open in the app JSON README (API)

About

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

Details

Kind
MCP servers
Topic
Finance & crypto
Publisher
anamized
Origin
official
Category
ferramentas
Transport
desconhecido
Version
0.1.0
Stars
1
Last push
2026-09-03T07:50:20Z
Repository state
ativo
Language
Python
Added
2026-08-29 03:01:39
Updated
2026-08-29 03:01:39
Origin id
io.github.ANAMIZED/needrail

README

# NeedRail

[![CI](https://github.com/ANAMIZED/needrail/actions/workflows/ci.yml/badge.svg)](https://github.com/ANAMIZED/needrail/actions/workflows/ci.yml)
[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)
[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
[![MCP](https://img.shields.io/badge/MCP-server-purple.svg)](src/needrail/mcp_server.py)

**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](https://donate.stripe.com/00w5kE3wOg5L8Jn2F243S00) |
| **Monthly Sponsor** | $25/mo | [Sponsor](https://donate.stripe.com/dRm28s4AS5r75xb1AY43S0c) |
| **Kernel Support** | $99 | [Donate](https://buy.stripe.com/bJecN63wObPv6Bf7Zm43S02) |

Agent rail: [x402-cloudflare-starter](https://github.com/ANAMIZED/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.

```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

More