Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

agent-tools (x402 + MCP + A2A directory)

✓ service owner · agent-tools.cloud

by AgentTools-Cloudversion 0.5.2i★ 1 (Stars for the whole repo)iComputer or cloudOfficial site ↗
Registry namecloud.agent-tools/agent-tools-mcp

How to install

What it does

Discover x402 services, MCP servers and A2A agents by intent — agent-tools.cloud directory.

  • Connects Computer or cloud
  • Account or key No key needed
  • Category Other

Why it ranks here

This one is in the “Apps that connect to AI” tab, which is ordered without stars, in this order

1. In Claude’s connector directoryNo
2. Tried by our teamNo
3. Works for Thai usersNo
4. Usage without stars32/100Popularity 12 · Freshness 12 · Still answering 8 · Likes from users +0
5. Listed on2026-11-14

Likes from users: 0 · Adds at most 5 points to the order (1 per person). It cannot be bought.

Quality: Passed 3/5 basic checks (shown, not used for ordering)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install agent-tools (x402 + MCP + A2A directory). Follow https://mcp.popnx.com/i/cloud-agent-tools-agent-tools-mcp.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 3/5 checks · What you ask goes through the maker’s server (agent-tools.cloud) · ✓ Commands checked Nov 14, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude · about 2 min

No key, nothing to install · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it

  1. Open Claude’s Connectors page

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Click “Add” → “Custom” → “Web” and fill in these 2 fields

    Copy each value into the field with the same name in Claude, then click Continue

    Name · Nameagent-tools (x402 + MCP + A2A directory)
    Remote MCP server URL · Addresshttps://agent-tools.cloud/mcp-discovery/

    Click Continue past the sign-in settings Claude detected · under Authentication choose what the maker says (Sign in now, Sign in when needed or No sign in), then click Add

  3. Turn it on in a chat

    +Connectorsagent-tools (x402 + MCP + A2A directory)

  4. Try it

    Use agent-tools (x402 + MCP + A2A directory) and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using agent-tools (x402 + MCP + A2A directory) or shows a agent-tools (x402 + MCP + A2A directory) tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with ChatGPT, depending on your plan

Full MCP: ChatGPT Business, Enterprise or Edu on the web · Pro: connects with read/fetch permissions, so tools that change data may not work · Plus: not confirmed in OpenAI’s docs; if you see an add-custom-MCP option on the Plugins page you can try these steps · web only

  1. Open ChatGPT’s add-MCP page on the web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Fill in the name and address

    Enter a name, paste the address under Connection, tick the risk warning and click Create as a plugin

    Name · Nameagent-tools (x402 + MCP + A2A directory)
    Connection · Addresshttps://agent-tools.cloud/mcp-discovery/
  3. Pick agent-tools (x402 + MCP + A2A directory) in a chat

    Start a new chat and pick agent-tools (x402 + MCP + A2A directory) from your plugins before typing

  4. Try it

    Use agent-tools (x402 + MCP + A2A directory) and tell me what you can do for me, then show me one thing

    ✓ If ChatGPT says it is using agent-tools (x402 + MCP + A2A directory) or shows a agent-tools (x402 + MCP + A2A directory) tool in the answer, you are connected

Menu names checked against OpenAI’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Claude Code · about 2 min

No key, nothing to install

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  2. Paste this command and press Enter

    claude mcp add --transport http --scope user agent-tools https://agent-tools.cloud/mcp-discovery/
  3. Type /mcp in Claude Code

    You should see agent-tools (x402 + MCP + A2A directory) listed as connected

  4. Try it

    Use agent-tools (x402 + MCP + A2A directory) and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using agent-tools (x402 + MCP + A2A directory) or shows a agent-tools (x402 + MCP + A2A directory) tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor · about 2 min

No key, nothing to install

  1. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  2. Open the AI chat in Cursor in Agent mode

  3. Try it

    Use agent-tools (x402 + MCP + A2A directory) and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using agent-tools (x402 + MCP + A2A directory) or shows a agent-tools (x402 + MCP + A2A directory) tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code · about 2 min

No key, nothing to install

  1. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  2. Open the AI chat in VS Code in Agent mode

  3. Try it

    Use agent-tools (x402 + MCP + A2A directory) and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using agent-tools (x402 + MCP + A2A directory) or shows a agent-tools (x402 + MCP + A2A directory) tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

Address for apps that connect over the web

Addresshttps://agent-tools.cloud/mcp-discovery/

JSON settings are under “For developers” below

Stuck? Ask people who use agent-tools (x402 + MCP + A2A directory)💬 Discussion →
For developers: Terminal commands and JSON settings

Over the web

Claude Code

claude mcp add --transport http --scope user agent-tools https://agent-tools.cloud/mcp-discovery/

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "agent-tools": {
      "url": "https://agent-tools.cloud/mcp-discovery/"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "agent-tools": {
      "type": "http",
      "url": "https://agent-tools.cloud/mcp-discovery/"
    }
  }
}

Installed on your computer

Claude Code

claude mcp add --scope user agent-tools -- uvx agent-tools-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "agent-tools": {
      "command": "uvx",
      "args": [
        "agent-tools-mcp"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "agent-tools": {
      "command": "uvx",
      "args": [
        "agent-tools-mcp"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "agent-tools": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "agent-tools-mcp"
      ]
    }
  }
}

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

GitHub starsi
1 (Stars for the whole repo)
This repo holds several MCP listings; its stars count once in rankings
Downloads per weeki
384/wk
Verified domain
✓ agent-tools.cloud
Licencei
No licence stated
Connection
Computer or cloud
Transport
stdio, streamable-http
Latest versioni
0.5.2
Categoryi
Other
Published to registryi
Nov 14, 2026
Code last changedi
Nov 18, 2026
Last checked
Nov 14, 2026
Maker
AgentTools-Cloud
Packages
pypi: agent-tools-mcp
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Connect over the internet in

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Tool names and descriptions exactly as the server reported them on Nov 14, 2026. The maker wrote them, not us; we show them as plain text.

  • search

    Find x402 / MCP services matching an intent or filter set. Two usage modes (agents pick whichever fits): A. Natural-language: `search(intent="fetch tweets for @user")` B. Pure browse: `search(has_mcp=True, category="defi", top_k=10)` At least one of `intent`, `category`, `chain`,

  • ask_services

    Ask for the best x402/MCP services for an agent intent. This is the high-level discovery tool: it retrieves candidates from the directory, asks the configured backend LLM to rank only those candidates, and returns service cards for the selected recommendations. If the LLM is unav

  • get

    Get full details + ready-to-paste call template for a service. Returns the service card with payment, call, quality, resource samples, and ready-to-use MCP/x402 call hints. Use this after `search` or `ask_services` before paying/calling an external service. Args: slug: Service sl

  • list_categories

    List all available service categories in the directory.

  • stats

    High-level stats about the directory: x402 total, healthy count and chains, plus `snapshot`, the daily digest across x402, MCP and A2A (see directory_stats).

  • get_methodology

    How every score and statistic on agent-tools.cloud is computed. Returns the quality-score components and grade bands per protocol, the nine readiness criteria with weights, payment-evidence grades, the probing schedule and the definitions behind the daily statistics.

  • list_articles

    List published Blog articles, newest first (metadata only). Args: query: Optional words to match in title, summary or body. tag: Optional tag to filter by. page: Page number, 20 articles per page. Use get_article(slug) for the full Markdown body.

  • get_article

    Read one published Blog article: metadata plus the full Markdown body. Args: slug: The article slug, as returned by list_articles.

  • directory_stats

    Daily statistics on the agent-tool ecosystem as seen by our probes. Args: view: "all", "mcp", "x402" or "a2a" to scope the figures to one protocol. topic: Optional topic word (e.g. "payment", "weather") to get that topic instead: supply per protocol, readiness, best listings, sea

  • search_mcp_servers

    Find MCP servers in the directory. Searches the standalone MCP directory (PulseMCP / official MCP registry import) unioned with x402 services that also expose an MCP endpoint. Returns normalised entries with a ready-to-use streamable-http `call_hint.mcp.url`. Args: intent: Natura

  • get_mcp_server

    Get the full card for one MCP server by slug. Args: slug: MCP server slug as returned by `search_mcp_servers` items.

  • search_a2a_agents

    Find A2A agents you can delegate a task to. Args: intent: Natural-language description of the task to delegate. top_k: Max agents to return (1-20). x402_only: When true, only return agents that advertise x402 payment.

  • search_resources

    Unified search across x402 services, MCP servers and A2A agents. Args: intent: Natural-language query. protocol: Optional filter: "x402", "mcp" or "a2a". top_k: Max resources to return (1-50).

  • register

    Self-register an x402 / MCP service in the agent-tools directory. Service owners and agents may submit new services here. Submissions are auto-reviewed instantly by x402 verification (no human gate): if the URL proves x402 payment support it is listed immediately and shows up in

  • scan_mcp_safety Looks like an instruction to the AI

    Check an MCP server for malware / prompt-injection lures by its endpoint URL. Give the server's streamable-http endpoint URL. Two paths: * **Already in the agent-tools directory** → returns our LATEST stored rule verdict. Every indexed server is re-scanned hourly, so you get a co

  • claim_service_url

    Issue a fresh ownership token for one exact public HTTPS URL. Authenticate in the MCP Authorization: Bearer header. Publishing and verifying the token is required before editing; URL input alone grants no rights. Args: url: Complete public HTTPS service URL, including its query w

  • verify_service_url

    Verify public ownership proof for your own exact service URL claim. This reads public proof only. It never calls business tools, requests private service credentials, or grants whole-platform permissions. Args: claim_id: Claim id returned by claim_service_url. token: The issued t

  • get_owned_listing

    Read editable metadata for a listing covered by your verified claim. Args: kind: Listing type: x402, mcp, or a2a. slug: Slug from the verified claim's listings or directory search.

  • edit_owned_listing

    Edit only metadata covered by your verified claim, with the public audit trail. An endpoint change requires verified control of the exact destination or its whole host and clears measurements tied to the old primary endpoint. Args: kind: Listing type: x402, mcp, or a2a. slug: Slu

  • create_api_key

    Create a free account API key. No sign-up, email or existing key needed. The key is returned once and cannot be recovered. Store it in your secret store; do not print it back to the user or write it to logs. Send it as `Authorization: Bearer ` (or the `api_key` argument where off

  • prepare_paid_verification

    Quote a sponsored paid verification of an x402 service. You pay the service once from your own wallet (Base USDC, <= $1; funds go to its payTo). Sign the returned `typed_data` (EIP-712), then call `execute_paid_verification` before `valid_before`. We never sign or hold funds. Aut

  • execute_paid_verification

    Send the signed payment to the service once and score the result. Aborts without paying if price or recipient changed. Never retried; a timeout returns `indeterminate`. status: succeeded | delivery_failed | payment_rejected | indeterminate. Args: id: `id` returned by `prepare_pai

  • get_paid_verification

    Read one of your own paid verifications. Args: id: Verification id. api_key: Optional if the Authorization header is sent.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified against the domain agent-tools.cloud (the registry checks domain ownership)

  • ✓ Pass

    Still maintained

    Code last changed yesterday

  • ! Caution

    Has a licence

    GitHub could not identify the licence type; open the file to check

  • ✓ Pass

    Endpoint responds

    Responded in 359 ms (HTTP 200)

  • – Not applicable

    Sign-in with OAuth

    No sign-in needed

  • ✕ Fail

    No hidden instructions in tool descriptions

    5 tool descriptions contain text that looks like instructions to the AI. Read them below before installing

Published vulnerabilities (OSV.dev)

No entries on OSV.dev for agent-tools-mcp@0.5.2

Checks only this package version, not every dependency · checked Nov 15, 2026

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/cloud-agent-tools-agent-tools-mcp.svg)](https://mcp.popnx.com/en/servers/cloud-agent-tools-agent-tools-mcp)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Otheri

  • More stars than 0% of the other 20653 servers in this category
  • Published to the registry more recently than 90% of the other 20653 servers in this category
  • Basic checks equal to or better than 11% of the other 20653 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is agent-tools (x402 + MCP + A2A directory) safe?

It passed 3 of 5 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

Either way works: install it on your computer or connect to the cloud version.

Is it still maintained?

The GitHub repo last changed yesterday, and the latest version (0.5.2) reached the registry 5 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT on the web (full MCP on Business and above; Pro read-only).

What can I use instead?

In the same category: World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.

by koala73Widely used★ 90.9KUpdated 3 days ago

Runs in the cloud✓ service owner · worldmonitor.app

openstatus

Manage monitors, status pages, incidents and maintenances in your openstatus workspace.

by openstatusHQWidely used★ 9.3KUpdated 2 months ago

Runs in the cloud✓ service owner · openstatus.dev

Oh My Posh Validator

Validate oh-my-posh configurations and segment snippets against the official schema.

by JanDeDobbeleerWidely used★ 23.8K Stars for the whole repoUpdated 30 days ago

Runs in the cloud✓ service owner · ohmyposh.dev

Strata

MCP server for progressive tool usage at any scale (see https://klavis.ai)

by Klavis-AIGrowing★ 5.8KUpdated 14 months ago

Runs in the cloudRepo archived✓ klavis.ai

Jitsu

Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.

by jitsucomWidely used★ 5.1KUpdated 4 months ago

Runs in the cloud✓ service owner · jitsu.com
Compared with similar ones
This one
agent-tools (x402 + MCP + A2A directory)
World MonitoropenstatusOh My Posh ValidatorStrataJitsu
Runs whereCloud or install on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to install
Needs a keyNoNoNoNoNoNo
Add with + in ClaudeNoNoNoNoNoNo
Basic checks3/54/44/44/41/44/4
LicenseNOASSERTIONAGPL-3.0AGPL-3.0MITApache-2.0MIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

mcpserver — agent-tools.cloud directory + MCP discovery

The server that powers agent-tools.cloud — an open, agent-readable directory of x402 paid APIs, MCP servers and A2A agents, probed daily, graded and safety-scanned, with a free MCP discovery endpoint and an A2A agent. Everything on the site (listings, daily statistics, scoring methodology, Blog) is available as JSON and through MCP tools.

Branches: main is an older public snapshot. The code that runs the site

today, including everything described below, is on the

directory-site branch.

Note (2026-05-25): the previously hosted paid Qwen3.6 relay and the paid

vertical endpoints (signal / onchain / defi / portfolio) were retired after

30 days of zero external conversions. This repository now serves the

directory site and the free MCP discovery server only.

What this serves today

PathAuthPurpose
GET / (host = agent-tools.cloud)freeDirectory site (search / browse)
GET /api/v1/searchfreeFaceted service search
POST /api/v1/askfree, rate-limitedLLM-ranked recommendations grounded in directory candidates
GET /api/v1/services/{slug}freeService card with payment, call and quality metadata
GET /api/v1/categories, /api/v1/statsfreeDirectory facets and aggregate stats
GET /stats, /stats.json, /stats/daily.csvfreeDaily ecosystem statistics page, full snapshot and history (CC BY 4.0)
`GET /api/v1/stats/summary?view=all\mcp\x402\a2a`freeCompact daily digest for agents
GET /api/v1/methodologyfreeHow quality grades, readiness scores and statistics are computed
GET /api/v1/blog, /api/v1/blog/{slug}freePublished Blog articles (list; full Markdown)
GET /llms.txtfreePlain-text guide for LLM agents
POST /api/v1/submitfree, rate-limitedPending service submission with dedupe
POST /api/v1/keysfreeMint an API key (no signup) for account-scoped actions
POST /api/v1/services/{slug}/paid-verificationsAPI keySponsored paid verification: quote, then /api/v1/paid-verifications/{id}/execute
POST /mcp-discovery/freeMCP streamable-http discovery server
POST /a2afreeA2A JSON-RPC agent (0.3 message/send and 1.0 SendMessage): directory search, MCP safety scan, daily statistics
GET /healthzfreeLiveness
GET /v1/modelsfreeUpstream model listing (read-only)
GET /.well-known/agent-tools.jsonfreeAgent discovery manifest
GET /.well-known/x402freex402 v0.4 self-description (free-only)
GET /.well-known/mcp.jsonfreeMCP self-description

The MCP discovery server is also published as a standalone PyPI package: agent-tools-mcp (repo).

MCP discovery tools

search(intent, top_k=5, category=None, max_price_usd=None, has_mcp=None)

ask_services(intent, top_k=5, category=None, max_price_usd=None, use_llm=True) get(slug) list_categories() stats() directory_stats(view="all") get_methodology() list_articles(query="", tag="", page=1) get_article(slug) search_mcp_servers(intent, top_k=5, chain=None, require_healthy=False) get_mcp_server(slug) search_a2a_agents(intent, top_k=5, x402_only=False) search_resources(intent, protocol=None, top_k=10) scan_mcp_safety(endpoint_url, name="", description="", tools_text="") register(url, name=None, description=None, mcp_url=None, category=None) prepare_paid_verification(slug, payer, api_key=None) execute_paid_verification(id, signature, api_key=None) get_paid_verification(id, api_key=None) claim_service_url(url, method=None) verify_service_url(claim_id, token) get_owned_listing(kind, slug) edit_owned_listing(kind, slug, fields)

*_paid_verification (remote server only, not in the agent-tools-mcp package): pay a listed x402 service once from your own wallet and record the result. Needs an API key from POST /api/v1/keys. See /about#paid-verification.

search accepts natural-language intent and ranks by FTS5 + popularity + health. Each result carries a match_reason and a confidence score. ask_services uses the same retrieval-first / LLM-rerank flow as /api/v1/ask.

scan_mcp_safety vets an MCP server (by endpoint URL) for malware / prompt-injection lures before you connect: an already-indexed server returns our latest stored verdict, an unknown one is probed live, scanned, and added to the directory if it answered or you supplied metadata (documentation hosts such as example.com, *.test, *.invalid are scanned but never listed). The verdict comes from deterministic static rules (no code execution) over the server's advertised name + description + tool docs. Rules cover pipe-to-shell / base64-eval / PowerShell install cradles, bare-IP payload hosts, prompt-injection phrasing, and MCP tool-poisoning coercion — "always call this tool first", "before using any other tool you must…", hidden instructions, "list all API keys / include secrets in your response", and coercion to read & forward .key/.pem/.ssh/.env files. Source-code-oriented rules (SQL/command/code injection) are intentionally not applied to natural-language descriptions to avoid false positives. Each live call also runs a frontier-LLM second opinion as an advisory dimension. It is also exposed as an A2A skill on POST /a2a. The hosted server carries the full tool set above; the stdio agent-tools-mcp PyPI package ships the core search tools only.

Deploy

Runs behind nginx as a systemd service (see deploy/).

cd <install-dir>

sudo git pull sudo systemctl restart mcpserver

systemd units live in deploy/:

  • mcpserver.service — the ASGI app (uvicorn, 127.0.0.1:9100)
  • mcpserver-b.service — second instance on 127.0.0.1:9101; nginx upstream agent_tools_app uses both, so deploy with agent-tools-rolling-restart instead of systemctl restart mcpserver
  • agent-tools-crawl.{service,timer} — daily directory crawler at 00:30
  • agent-tools-health.{service,timer} — daily endpoint health checks at 05:30

Config

See .env.example. Required:

  • UPSTREAM_BASE_URL / UPSTREAM_API_KEY — used by /v1/models
  • AGENT_TOOLS_ASK_BASE_URL / AGENT_TOOLS_ASK_API_KEY / AGENT_TOOLS_ASK_MODEL — LLM backend for /api/v1/ask
  • AGENT_TOOLS_SAFETY_BASE_URL / AGENT_TOOLS_SAFETY_API_KEY / AGENT_TOOLS_SAFETY_MODEL — optional override for the scan_mcp_safety advisory LLM (falls back to the AGENT_TOOLS_ASK_* backend)
  • AGENT_TOOLS_DB_PATH — SQLite path for the directory
  • AGENT_TOOLS_ASK_RATE_LIMIT_PER_MINUTE / AGENT_TOOLS_ASK_RATE_LIMIT_PER_DAY — public ask abuse limits
  • METRICS_BEARER_TOKEN — optional remote access token for /metrics; without it metrics are local-only

Articles (optional)

Disabled by default. ARTICLES_ENABLED=1 enables /articles (list, detail, RSS, Markdown mirror), the author workspace /account/articles and editor review /admin/articles. Articles live in a separate SQLite file (ARTICLE_DB_PATH, default articles.db next to the main database); back it up with the SQLite backup API so the WAL is not lost.

  • Authors must hold at least one verified listing claim. The REST API (/api/v1/articles, /save, /submit, /cancel-submission, /preview, /media) accepts only Authorization: Bearer .
  • Every submission is reviewed; only accounts in ARTICLE_EDITOR_IDS can publish. Public pages read the published version only.
  • Toolbar icons come from lucide-static 1.70.0 (licence kept in directory/article_assets/LICENSE).
Sponsored publication (optional)

Paid sponsored posts use a NOWPayments hosted invoice plus a signed IPN (HMAC-SHA512 over the sorted JSON body). The private JSON config is read from NOWPAYMENTS_ARTICLES_CONFIG (default /etc/agent-tools/nowpayments-articles.json, keep it mode 0600). Order, pricing and IPN endpoints return 404 unless the config is complete and sponsored_articles_enabled is true. Sponsored posts carry a visible "Sponsored" disclosure and their links get rel="sponsored"; payment never changes directory ranking.

Smoke test

# Liveness

curl https://agent-tools.cloud/healthz

Directory stats

curl https://agent-tools.cloud/api/v1/stats

Intent-level service recommendation

curl -s -X POST https://agent-tools.cloud/api/v1/ask \ -H 'content-type: application/json' \ -d '{"query":"find a weather API that accepts x402","limit":2}'

Service card

curl https://agent-tools.cloud/api/v1/services/weather-hugen-tokyo-scan

MCP discovery handshake

curl -s -X POST https://agent-tools.cloud/mcp-discovery/ \ -H 'content-type: application/json' \ -H 'accept: application/json, text/event-stream' \ -d '{"jsonrpc":"2.0","id":1,"method":"initialize", "params":{"protocolVersion":"2025-06-18","capabilities":{}, "clientInfo":{"name":"smoke","version":"1"}}}'

Retired paid path -> 404

curl -s -o /dev/null -w '%{http_code}\n' -X POST \ https://agent-tools.cloud/v1/chat/completions \ -H 'content-type: application/json' \ -d '{"model":"Qwen/Qwen3.6-35B-A3B","messages":[{"role":"user","content":"hi"}]}'

=> 404

License

The agent-tools.cloud server and directory code in this repository is licensed under the [PolyForm Noncommercial License 1.0.0](LICENSE) — you may use, modify, and share it for any noncommercial purpose; commercial use is not permitted.

The standalone MCP client package in agent-tools-mcp/ (published to PyPI as agent-tools-mcp) is licensed separately under [Apache-2.0](agent-tools-mcp/LICENSE), so any agent — including commercial ones — can install and call the hosted service freely.

Using the hosted service at agent-tools.cloud is governed by its terms of service, not this code license.