About 402index
402index is an MCP server for AI agent service discovery, querying paid APIs in the 402 Index directory. It supports filters for protocol, category, health, and price, alongside service details and directory statistics.
Key features
- 01Filter paid API services
- 02View service details and health history
- 03List categories and service counts
- 04Check directory health and sync times
Use cases
- 01Find healthy L402 weather APIs
- 02Filter services by protocol, category, or price
- 03Review service details and health history
- 04Check the total number of directory services
MCP support
The MCP server exposes tools for searching services, viewing details, listing categories, and checking directory statistics.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
4Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| q | string | No | Search by name, description, or URL |
| sort | enum | No | Sort fieldname | price | latency | uptime |
| limit | number | No | Results per page (default 10, max 200) |
| order | enum | No | Sort orderasc | desc |
| fields | string | No | Comma-separated fields (default: name,url,protocol,price_sats,health_status). Use * for all fields. |
| format | enum | No | Response format (default: json). CSV reduces token usage by ~29% for tabular data.json | csv |
| health | enum | No | Filter by health statushealthy | degraded | down | unknown |
| offset | number | No | Pagination offset |
| source | enum | No | Filter by sourcebazaar | satring | l402apps | sponge | l402directory | mpp | discovery | self-registered |
| category | string | No | Filter by category (prefix match — "crypto" matches "crypto/nft") |
| featured | boolean | No | Only featured services |
| protocol | enum | No | Filter by payment protocolL402 | x402 | MPP |
| verified | boolean | No | Only payment-verified services (x402: valid payment headers, L402/MPP: healthy). Domain-verified ranked first. Recommended for agents making payment decisions. |
| max_price_usd | number | No | Maximum price in USD |
Details
From the project README402 Index MCP Server
MCP server for AI agent service discovery via the 402 Index directory.
Tools
| Tool | Description |
|---|---|
search_services | Search/filter paid API services (protocol, category, health, price, etc.) |
get_service_detail | Get full details for a single service including health check history |
list_categories | List all categories with service counts |
get_directory_stats | Directory health, totals, sync timestamps |
Setup
cd mcp-server
npm install
npm run build
Configuration
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"402index": {
"command": "node",
"args": ["/path/to/402index/mcp-server/dist/index.js"],
"env": {
"INDEX_URL": "https://402index.io"
}
}
}
}
Claude Code
Add to .claude/settings.json or run:
claude mcp add 402index node /path/to/402index/mcp-server/dist/index.js
Cursor
Add to .cursor/mcp.json:
{
"mcpServers": {
"402index": {
"command": "node",
"args": ["/path/to/402index/mcp-server/dist/index.js"]
}
}
}
Environment Variables
| Variable | Default | Description |
|---|---|---|
INDEX_URL | https://402index.io | Base URL of the 402 Index API |
Example Prompts
- "Find healthy L402 weather APIs under $0.01"
- "What categories of paid APIs are available?"
- "Show me details for service 42"
- "How many services are in the directory?"
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.