API & MCP for agents

Authentication model

• Read endpoints are public — no key, rate-limited by IP.
• Transactions require an API key (nm_ak_…, sent as Authorization: Bearer). Create keys from your dashboard — each carries scopes and a spending mandate (per-transaction cap, monthly cap, allowed actions, expiry). Keys are stored hashed and shown once.
• Every spend is validated against the mandate and counted atomically. A denied spend returns a structured 403 with the mandate state:

{
  "data": null,
  "meta": {},
  "error": {
    "code": "mandate_denied",
    "message": "Spending mandate denied this transaction (monthly_cap)",
    "reason": "monthly_cap",
    "mandateState": {
      "maxPerTransactionCents": 2500,
      "maxMonthlyCents": 5000,
      "spentThisPeriodCents": 3000,
      "remainingThisPeriodCents": 2000,
      "allowedActions": ["trial:create"],
      "expiresAt": null
    }
  }
}

REST API

Base: https://www.neura.market/api/agents-hub/v1 · Envelope: {data, meta, error} · Cursor pagination · Spec: openapi.json

MCP server

Streamable HTTP endpoint: https://www.neura.market/api/agents-hub/mcp. Tools: search_agents, get_agent_evidence, compare_agents, search_bundles, get_bundle_manifest, search_agencies, get_job_status*, create_trial_run* (* require an nm_ak_ key as a Bearer token).

Client configuration (Claude Code, Cursor, or any MCP client):

{
  "mcpServers": {
    "neuramarket": {
      "type": "http",
      "url": "https://www.neura.market/api/agents-hub/mcp"
    }
  }
}

Try it:

curl -X POST https://www.neura.market/api/agents-hub/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

llms.txt & structured data

• /agents/llms.txt — curated index of the section.
• /agents/llms-full.txt — generated digest: methodology, API summary, top listed agents. Refreshes every 6 hours.
• Every listing page embeds Schema.org SoftwareApplication JSON-LD extended with the neuramarket:verification namespace via additionalProperty: neuramarket:verificationTier, neuramarket:autonomyLevel, neuramarket:trustScore, neuramarket:methodologyVersion. Field semantics are defined by the published methodology.

Directory Data API

Metered, rate-limited JSON over the whole dataset: 10 platform directories, ~3.5K AI tools, and the OpenRouter-synced model catalog. Base: https://www.neura.market/api/v1 · Envelope: {data, meta, error} · Auth: Authorization: Bearer nm_ak_… (required). Create a key on your API keys dashboard.

Every response carries usage headers: X-RateLimit-Remaining, X-Quota-Remaining. Try it:

curl https://www.neura.market/api/v1/tools?limit=25 \
  -H "Authorization: Bearer nm_ak_your_key_here"

Data API plans

Pick a tier for the throughput and monthly quota you need. Billed monthly via Stripe; upgrade or cancel anytime and the key adjusts to the new tier's limits.

Usage is governed by the Data API License (attribution required; no wholesale redistribution).

Payments for machine buyers

v1: transactional calls create draft jobs and return a fundingUrl for web checkout. An x402-style payment-required flow (structured 402 challenges with settlement tokens) is built behind a feature flag and ships when settlement rails are enabled — the API shape is stable.