# needrail

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/ANAMIZED/NeedRail  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/needrail

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

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "needrail": {
    "command": "npx",
    "args": ["-y","needrail"]
  }
}
```

## Documentation & 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).

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

