Home / Token cost / Geo

The Geo MCP server costs 8,007 tokens before the first call.

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

QUICK ANSWER The Geo MCP server's tool definitions consume 8,007 tokens — 4.2× the median MCP server (1,905 tokens). A scoped grant exposing only the tools you use cuts that roughly in proportion.

MEASURED FROM SCHEMAS 44 tools · 8,007 tokens · 4.0% of 200k · 0.8% 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 4.0%
1M WINDOW 0.8%

Corpus context: Geo ranks #295 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 8,007 tokens go.

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

ToolCategoryTokens% of server
create_research_ontology_paper_and_claims Write 682 8.5%
create_entity Write 658 8.2%
create_research_paper_and_claims Write 653 8.2%
create_knowledge_graph Write 609 7.6%
update_entity Write 600 7.5%
build_schema Execute 294 3.7%
upsert_workspace_entity Write 226 2.8%
upsert_canvas_workflow Write 225 2.8%
search_entities Read 173 2.2%
add_values_to_entity Write 173 2.2%
configure_wallet Write 171 2.1%
list_entities Read 170 2.1%
vote_on_proposal Write 156 1.9%
create_knowledge_graph_from_file Write 155 1.9%
propose_remove_subspace Destructive 150 1.9%
read_local_file Read 150 1.9%
propose_accept_subspace Write 150 1.9%
propose_dao_edit Write 145 1.8%
delete_workspace_entity Destructive 136 1.7%
create_property Write 135 1.7%
get_proposal_votes Read 127 1.6%
get_proposals Read 126 1.6%
list_spaces Read 124 1.5%
propose_accept_editor Write 124 1.5%
propose_remove_editor Destructive 123 1.5%
list_types Read 123 1.5%
resolve_workspace_entities Write 122 1.5%
create_relation Write 111 1.4%
submit_signed_transaction Write 109 1.4%
create_type Write 103 1.3%
get_system_ids Read 95 1.2%
create_image Write 95 1.2%
get_page_content Read 92 1.1%
get_type Read 83 1.0%
generate_id Write 82 1.0%
get_entity Read 79 1.0%
get_space Read 76 0.9%
get_proposal Read 74 0.9%
publish_edit Write 67 0.8%
delete_entity Destructive 66 0.8%
delete_relation Destructive 66 0.8%
setup_space Write 48 0.6%
get_session_status Read 41 0.5%
clear_session Destructive 40 0.5%

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

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 (182 tokens each).

Grant scopeDefinition costReduction
All 44 tools (no gateway) 8,007 tokens
3 granted tools ~546 tokens −93%
5 granted tools ~910 tokens −89%
10 granted tools ~1,820 tokens −77%

Geo token-cost questions.

How many tokens does the Geo MCP server use?+

Its 44 tool definitions total 8,007 tokens — 4.0% 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 Geo 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 Geo's token usage?+

Expose fewer tools. A PolicyLayer grant scopes Geo 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 546 tokens, a 93% 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 44 catalogued Geo tools. Counts refresh with every site build.

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

A PolicyLayer grant scopes Geo 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.