Skip to main content
Glama

nohumans.directory — MCP server

Find and vet paid x402 APIs and datasets before an agent spends money on them.

nohumans.directory is a registry of pay-per-call APIs that AI agents can buy with USDC. Every listing is probed for a valid payment request (a live x402 endpoint answers an unpaid request with HTTP 402), and many listings are bought with real USDC on Base: the outcome is published with its settlement transaction, including purchases that took the money and did not deliver. Placement in results is never sold.

All tools are free and read-only. No API key, no account. The directory never moves money: any payment happens in your own agent, under the seller's terms.

Website: https://nohumans.directory · Live stats: https://nohumans.directory/stats · API reference for agents: https://api.nohumans.directory/llms.txt

Install

The server is remote: Streamable HTTP, no authentication.

https://api.nohumans.directory/mcp

Claude Code:

claude mcp add --transport http nohumans https://api.nohumans.directory/mcp

Clients that read an mcpServers block with remote servers:

{ "mcpServers": { "nohumans": { "type": "http", "url": "https://api.nohumans.directory/mcp" } } }

Clients that only run local (stdio) servers: use the nohumans-mcp npm package, a small bridge to the same server (no dependencies, Node 18+):

{ "mcpServers": { "nohumans": { "command": "npx", "args": ["-y", "nohumans-mcp"] } } }

The bridge is index.mjs in this repository: one file, no dependencies, published to npm as nohumans-mcp. NOHUMANS_MCP_URL overrides the endpoint.

Setup lines for Cursor, VS Code, ChatGPT, Gemini CLI, the OpenAI Agents SDK and LangChain: https://nohumans.directory/integrate#connect

Related MCP server: x402-discovery

Tools

Tool

What it does

find_paid_service

Search by need: query (describe the need specifically), category, max_price, min_score (0..1), protocol (x402 or mpp), mpp_method, limit. Ranked verified first, then probe score, then price.

get_service_details

One listing's full record by id: request shape, observed payment terms, probe history, latest purchase outcome.

resolve_endpoint

Check an endpoint url you already hold: listed, delisted, or never checked here (not the same as unsafe).

what_agents_are_asking_for

The aggregate demand feed: what agents search this directory for. For sellers deciding what to build or list.

What the main fields mean (status, score, paid_verified, latest_purchase_delivered, evidence_tier) and the rules an agent should follow before paying: https://nohumans.directory/integrate#rules

Agent Skill

For agents that support Agent Skills (Claude Code and others):

mkdir -p ~/.claude/skills/nohumans-directory
curl -o ~/.claude/skills/nohumans-directory/SKILL.md \
  https://raw.githubusercontent.com/jalcodev/nohumans-mcp/main/skills/nohumans-directory/SKILL.md

Selling an API

List it at https://nohumans.directory/submit (check it free first). What it costs and what you get: https://nohumans.directory/sellers. Notes for submitters: SUBMITTING.md.

Method

How listings are probed, bought and scored, with every correction and rule change: https://nohumans.directory/methodology

Licence

Contents of this repository: MIT. Directory data: CC BY 4.0, credit "nohumans.directory" with a link.

Available Tools

4 tools
find_paid_serviceFind a paid serviceA
Read-onlyIdempotent
Inspect

Search paid x402 APIs and datasets by need. Ranked: verified first, then probe score, then price. Each result carries what you choose on: status, score (0..1), evidence_tier, paid_verified (we bought it with real USDC and it delivered), latest_purchase_delivered (false = our most recent paid purchase took real USDC and did not deliver: do not pay it), has_sample (a cheap preview exists), price. Relevance comes from the query text; a specific need in plain words matches best. Zero results means nothing listed matches. Results are dated evidence, not guarantees. Returns a summary per listing; detail='full' returns every field. Free, read-only.

Inputs: limit, query, detail, category, +4 more. Returns: count, detail, results, category_expanded

get_service_detailsGet a paid service's full recordA
Read-onlyIdempotent
Inspect

Full record for one listing id: request and response schemas, sample_query, observed 402 terms (network, payTo, scheme, x402 version), reputation detail, and paid_verification (our latest real USDC purchase, with its settlement tx where proven). Useful before paying: it shows the exact request shape and current reliability. Every timestamp has an _iso twin; on-chain counts describe the seller's wallet, usually shared by several listings, not this endpoint. Free, read-only.

Inputs: id (required). Returns: id, kind, name, score, +53 more

resolve_endpointCheck an endpoint URL before payingA
Read-onlyIdempotent
Inspect

Check an endpoint URL you already hold before paying it. Returns match 'active' with the listing's full record, 'delisted' (listed here, later removed), or 'unknown' (never checked here; absence is not a verdict either way). The record is dated evidence, not a safety rating. Free, read-only.

Inputs: url (required). Returns: note, match, detail

what_agents_are_asking_forWhat agents are asking forA
Read-onlyIdempotent
Inspect

What agents searched this directory for, for deciding which x402 service to build or list. Terms ranked by how many distinct days they were asked, each with catalogue_top: the listings our own search already returns for it. A term being asked does not mean nothing serves it. The window ends a week behind live while the paid tier is on sale (a day when it is not; delay_hours and window_ends_at in the response say which); test traffic, sellers searching their own listings and identifying terms are excluded; floor: a term appears once at least 1 distinct non-seller client IP asked it. Client counts are IP ceilings, never buyer counts. Paged: limit (default 25), offset, next_offset. Free, read-only.

Inputs: limit, offset. Returns: note, page, top_needs, read_first, +11 more

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 4 tools

    Disambiguation4/5

    Each tool has a clear primary axis: search by need, fetch by id, resolve by URL, and read aggregate demand terms. The only friction is between get_service_details and resolve_endpoint, since resolve_endpoint also returns 'the listing's full record' for a known URL, so an agent holding both an id and a URL could hesitate between them. Descriptions do enough to resolve this in practice.

    Naming Consistency4/5

    Three tools follow a clean verb_noun snake_case pattern (find_paid_service, get_service_details, resolve_endpoint). The fourth, what_agents_are_asking_for, breaks the pattern with a full question-phrase name, which is memorable and readable but inconsistent with the rest of the set.

    Tool Count4/5

    Four read-only tools for a directory search/vetting server is tight and well-scoped, with no filler tools. It sits near the thin end of the range, and a couple of capabilities (e.g. listing/comparing) are absent rather than extra.

    Completeness4/5

    The discover → inspect → verify lifecycle is covered: search, detail by id, resolve an externally held URL, plus a seller-side demand signal. The obvious gap is that the surface is purely read-only — there is no tool to submit/register a listing or to actually probe/sample a paid endpoint, which the descriptions repeatedly gesture at ('has_sample', 'a cheap preview exists') without exposing.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Discovers and routes across 251+ x402-enabled payment services with smart routing strategies (cheapest, fastest, most trusted) and signed attestations. Provides real-time health monitoring, facilitator compatibility checks, and service quality scoring for the x402 agent payment ecosystem.
      5
      4
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Discovers and queries x402-payable APIs at runtime — enables autonomous agents to find, evaluate, and pay for services via USDC micropayments on Base without API keys or subscriptions.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables MCP-compatible agents to discover and call x402 paid services from a directory of over 2,000 APIs.
      Apache 2.0
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables AI agents to search and verify machine-payable HTTP 402/x402 APIs using live probe data, providing ranked results by liveness, uptime, price, and trustworthiness.
      -