Home / Token cost / Agent Registry

The Agent Registry MCP server costs 4,944 tokens before the first call.

Connect Agent Registry and its 36 tool definitions are loaded into the model's context on every request — 2.5% of a 200k window spent before your agent does anything.

QUICK ANSWER The Agent Registry MCP server's tool definitions consume 4,944 tokens — 2.6× the median MCP server (1,905 tokens). A scoped grant exposing only the tools you use cuts that roughly in proportion.

MEASURED FROM SCHEMAS 36 tools · 4,944 tokens · 2.5% of 200k · 0.5% of 1M Method →

What that buys before your agent starts working.

Tool definitions are overhead: they occupy context on every request and compete with your code, documents and conversation history for the same window.

200K WINDOW 2.5%
1M WINDOW 0.5%

Corpus context: Agent Registry ranks #1033 of 3,213 measured MCP servers by definition cost. The median is 1,905 tokens, p90 is 7,952, and the heaviest (Fusionauth) is 183,337 — 92% of a 200k window on its own.

Where the 4,944 tokens go.

Each row is one tool definition as a tools/list entry — name, description and input schema — counted with o200k_base. Average: 137 tokens per tool.

ToolCategoryTokens% of server
register_agent_api_agents_register_post Write 468 9.5%
update_payment_profile_api_payments_ecash_profile__agent_id__put Write 311 6.3%
search_agents_api_agents_search_get Read 264 5.3%
list_agents_api_agents_get Read 244 4.9%
send_ecash_api_payments_ecash_send_post Write 218 4.4%
submit_intake_api_broker_intake_post Write 213 4.3%
a2a_public_discovery_api_agents_public_get Read 212 4.3%
create_quote_api_payments_ecash_mint_quote_post Write 157 3.2%
payment_required_api_payments_ecash_402__agent_id__get Read 155 3.1%
get_agent_api_agents__agent_id__get Read 151 3.1%
list_transactions_api_payments_ecash_transactions_get Read 144 2.9%
create_melt_quote_api_payments_ecash_melt_quote_post Write 143 2.9%
receive_ecash_api_payments_ecash_receive_post Write 130 2.6%
list_categories_api_agents_categories_get Read 129 2.6%
get_scan_results_api_scanner_results_get Read 122 2.5%
trigger_scan_api_scanner_scan_post Execute 115 2.3%
claim_agent_api_agents_claim_post Write 112 2.3%
check_quote_api_payments_ecash_mint_quote__quote_id__get Read 105 2.1%
get_badge_svg_api_badges__agent_id__svg_get Read 105 2.1%
get_card_history_api_agents__agent_id__card_history_get Read 100 2.0%
get_mint_keysets_api_payments_ecash_mint_keysets_get Read 100 2.0%
get_badge_json_api_badges__agent_id__json_get Read 98 2.0%
get_intake_api_broker_intake__intake_id__get Read 97 2.0%
get_mint_keys_api_payments_ecash_mint_keys_get Read 97 2.0%
get_mint_info_api_payments_ecash_mint_info_get Read 95 1.9%
send_outreach_api_admin_outreach_post Write 90 1.8%
a2a_public_agent_card_api_agents_public__agent_id__get Read 86 1.7%
agent_payment_summary_api_payments_ecash_summary__agent_id__get Read 85 1.7%
discover_single_agent_api_registry_discover__agent_id__post Write 83 1.7%
get_badge_embed_code_api_badges__agent_id__embed_get Read 82 1.7%
get_payment_profile_api_payments_ecash_profile__agent_id__get Read 80 1.6%
verify_token_api_payments_ecash_verify_post Read 80 1.6%
get_agent_trust_api_agents__agent_id__trust_get Read 77 1.6%
list_ecash_agents_api_payments_ecash_agents_get Read 69 1.4%
trigger_discovery_cycle_api_registry_discover_post Execute 68 1.4%
get_registry_stats_api_registry_stats_get Read 59 1.2%

Most agents use a handful of these tools. They pay for all 36.

A PolicyLayer grant exposes only the tools you allow — ungranted definitions are filtered out of the tool list, so they never enter the context window. Estimates below assume typical-weight tools (137 tokens each).

Grant scopeDefinition costReduction
All 36 tools (no gateway) 4,944 tokens
3 granted tools ~412 tokens −92%
5 granted tools ~687 tokens −86%
10 granted tools ~1,373 tokens −72%

Agent Registry token-cost questions.

How many tokens does the Agent Registry MCP server use?+

Its 36 tool definitions total 4,944 tokens — 2.5% of a 200k context window — measured with tiktoken o200k_base over the serialised tools/list payload. Exact counts vary slightly by client and model.

Why does Agent Registry consume tokens before I send a message?+

MCP clients load every connected server's tool definitions — name, description, and input schema — into the model's context so it knows what it can call. That payload is charged against your context window on every request, whether or not a tool is used.

How do I reduce Agent Registry's token usage?+

Expose fewer tools. A PolicyLayer grant scopes Agent Registry to only the tools you allow — ungranted definitions are filtered out of the tool list, so they never enter the context window. A grant of 3 typical tools costs roughly 412 tokens, a 92% reduction.

Does deferred tool loading fix this?+

Partially, in some clients. Claude Code defers MCP tool schemas behind a tool-search step by default, and VS Code has experimental grouping — but you still pay tokens per search and reload, and Cursor, Windsurf and Gemini CLI load definitions upfront. Reducing the exposed tool set cuts the cost in every client.

How these numbers were measured.

01
Serialisation

Each tool is serialised as a tools/list entry — name, description, input schema — from the schemas in the PolicyLayer scan database. Clients differ slightly in framing, so treat counts as close estimates.

02
Tokeniser

tiktoken o200k_base (GPT-4o/o-series). Anthropic's current tokeniser isn't published, so Claude's exact counts will differ; for English text and JSON schemas the totals are close enough to treat these as estimates.

03
Deferred loading

Some clients now defer schema loading (Claude Code's tool search; VS Code experimental grouping). You still pay per search and reload — and Cursor, Windsurf and Gemini CLI load everything upfront.

Computed 07-06-2026 from the PolicyLayer scan database over all 36 catalogued Agent Registry tools. Counts refresh with every site build.

Expose only the tools you use — the rest never enter your context.

A PolicyLayer grant scopes Agent Registry to the tools you actually allow. Ungranted definitions never load, and every call that does run is checked against policy first.

Free to start. No card required.

4,600+ MCP servers and 31,000+ tools scanned and risk-classified.

// GET IN TOUCH

Have a question or want to learn more? Send us a message.

Message sent.

We'll get back to you soon.