// MCP TOKEN COST

The Gogcli MCP server costs 14,047 tokens before the first call.

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

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

MEASURED FROM SCHEMAS 109 tools · 14,047 tokens · 7.0% of 200k · 1.4% of 1M Method →

// CONTEXT WINDOW SHARE

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 7.0%

1M WINDOW 1.4%

Corpus context: Gogcli ranks #104 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.

// PER-TOOL BREAKDOWN

Where the 14,047 tokens go.

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

Tool	Category	Tokens	% of server
gog_classroom_coursework_create	Write	266	1.9%
gog_classroom_coursework_update	Write	244	1.7%
gog_calendar_create	Write	219	1.6%
gog_classroom_coursework_list	Read	210	1.5%
gog_slides_create_from_template	Write	202	1.4%
gog_calendar_events	Read	198	1.4%
gog_classroom_submissions_list	Read	198	1.4%
gog_calendar_update	Write	194	1.4%
gog_sheets_run	Execute	189	1.3%
gog_classroom_run	Execute	187	1.3%
gog_classroom_courses_update	Write	186	1.3%
gog_gmail_send	Write	179	1.3%
gog_classroom_courses_create	Write	178	1.3%
gog_docs_run	Read	174	1.2%
gog_drive_ls	Read	174	1.2%
gog_drive_share	Read	172	1.2%
gog_drive_run	Execute	171	1.2%
gog_gmail_run	Execute	170	1.2%
gog_classroom_roster	Read	169	1.2%
gog_calendar_run	Execute	168	1.2%
gog_contacts_run	Execute	168	1.2%
gog_tasks_run	Execute	168	1.2%
gog_classroom_courses_list	Read	168	1.2%
gog_sheets_update	Write	167	1.2%
gog_slides_add_slide	Write	167	1.2%
gog_sheets_append	Read	164	1.2%
gog_auth_add	Write	164	1.2%
gog_slides_replace_slide	Write	161	1.1%
gog_classroom_submissions_grade	Write	157	1.1%
gog_slides_run	Execute	156	1.1%
gog_classroom_announcements_list	Read	154	1.1%
gog_contacts_create	Write	151	1.1%
gog_slides_create_from_markdown	Write	151	1.1%
gog_docs_write	Read	144	1.0%
gog_slides_update_notes	Write	144	1.0%
gog_classroom_announcements_update	Write	143	1.0%
gog_calendar_respond	Read	142	1.0%
gog_gmail_search	Read	142	1.0%
gog_sheets_get	Read	138	1.0%
gog_tasks_add	Write	138	1.0%
gog_classroom_invitations_create	Write	137	1.0%
gog_classroom_invitations_list	Read	134	1.0%
gog_classroom_announcements_create	Write	133	0.9%
gog_slides_export	Write	133	0.9%
gog_classroom_students_add	Write	132	0.9%
gog_classroom_submissions_reclaim	Write	131	0.9%
gog_auth_run	Execute	130	0.9%
gog_classroom_students_list	Read	127	0.9%
gog_classroom_teachers_list	Read	127	0.9%
gog_classroom_submissions_turn_in	Read	126	0.9%
gog_classroom_topics_list	Read	126	0.9%
gog_slides_copy	Write	124	0.9%
gog_drive_delete	Destructive	123	0.9%
gog_classroom_submissions_return	Read	123	0.9%
gog_classroom_submissions_get	Read	122	0.9%
gog_slides_create	Write	122	0.9%
gog_docs_find_replace	Read	121	0.9%
gog_sheets_find_replace	Read	120	0.9%
gog_classroom_topics_update	Write	115	0.8%
gog_sheets_clear	Destructive	114	0.8%
gog_slides_read_slide	Read	112	0.8%
gog_gmail_get	Read	111	0.8%
gog_classroom_coursework_get	Read	107	0.8%
gog_drive_move	Write	107	0.8%
gog_classroom_teachers_remove	Destructive	106	0.8%
gog_slides_delete_slide	Destructive	106	0.8%
gog_classroom_teachers_add	Write	106	0.8%
gog_classroom_students_remove	Destructive	105	0.7%
gog_classroom_students_get	Read	105	0.7%
gog_classroom_teachers_get	Read	105	0.7%
gog_drive_rename	Write	105	0.7%
gog_classroom_coursework_delete	Destructive	104	0.7%
gog_docs_structure	Read	104	0.7%
gog_classroom_announcements_get	Read	103	0.7%
gog_tasks_get	Read	103	0.7%
gog_classroom_topics_get	Read	102	0.7%
gog_tasks_done	Read	102	0.7%
gog_classroom_topics_create	Write	102	0.7%
gog_calendar_get	Read	101	0.7%
gog_classroom_announcements_delete	Destructive	100	0.7%
gog_tasks_delete	Destructive	100	0.7%
gog_classroom_topics_delete	Destructive	99	0.7%
gog_calendar_delete	Destructive	98	0.7%
gog_tasks_list	Read	97	0.7%
gog_sheets_metadata	Read	96	0.7%
gog_slides_info	Read	96	0.7%
gog_classroom_profile_get	Read	95	0.7%
gog_docs_info	Read	95	0.7%
gog_sheets_create	Write	95	0.7%
gog_contacts_get	Read	94	0.7%
gog_contacts_search	Read	94	0.7%
gog_docs_create	Read	94	0.7%
gog_classroom_invitations_delete	Destructive	93	0.7%
gog_classroom_courses_unarchive	Write	92	0.7%
gog_classroom_invitations_get	Read	90	0.6%
gog_docs_cat	Read	90	0.6%
gog_classroom_invitations_accept	Read	89	0.6%
gog_classroom_courses_get	Read	88	0.6%
gog_slides_list_slides	Read	88	0.6%
gog_classroom_courses_delete	Destructive	85	0.6%
gog_drive_get	Read	85	0.6%
gog_classroom_courses_archive	Write	85	0.6%
gog_drive_search	Read	84	0.6%
gog_drive_mkdir	Write	84	0.6%
gog_tasks_lists	Read	64	0.5%
gog_contacts_list	Read	63	0.4%
gog_auth_list	Read	57	0.4%
gog_auth_status	Read	54	0.4%
gog_auth_services	Read	52	0.4%

// SCOPED GRANT

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

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

Grant scope	Definition cost	Reduction
All 109 tools (no gateway)	14,047 tokens	—
3 granted tools	~387 tokens	−97%
5 granted tools	~644 tokens	−95%
10 granted tools	~1,289 tokens	−91%

Model your own stack in the token-cost calculator, or see the Gogcli policy for what a sensible grant looks like.

//FAQ

Gogcli token-cost questions.

How many tokens does the Gogcli MCP server use?+

Its 109 tool definitions total 14,047 tokens — 7.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 Gogcli 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 Gogcli's token usage?+

Expose fewer tools. A PolicyLayer grant scopes Gogcli 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 387 tokens, a 97% 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.

// METHOD & REVIEW

How these numbers were measured.

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.

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.

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 109 catalogued Gogcli tools. Counts refresh with every site build.

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

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

SCOPE YOUR GRANT →

Free to start. No card required.

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