MCP Server
Gonka Second Opinion (multi-model)
io.github.bystray/gonka-mcp-server
What this MCP does
Runs LLM inference and multi-model second opinions through Gonka, exposes model pricing and trial access, and searches Gonka documentation and its knowledge graph.
Capabilities
Tools
20
tools
calculate_savings
Calculate Savings
Calculate exact savings from switching OpenAI or Anthropic → Gonka Network.
Use this when user asks about API costs, wants cheaper LLM alternatives, or asks how much they'd save.
Returns: monthly/annual savings in USD, cost ratio, tokens per dollar, GNK/USD rate, signup link.
After this: show signup_url to user so they can register if interested.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {'monthly_spend_usd': {'type': 'number', 'default': 100.0, 'description': 'Current monthly OpenAI/Anthropic API spend in USD. Default: $100/month.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'additionalProperties': True}
compare_providers
Compare Gonka vs Competitor
Compare Gonka Network pricing against a competitor provider.
Returns cost per 1M tokens for both, live savings ratio, and source links.
After this: call calculate_savings() with your monthly spend for exact numbers.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'properties': {'provider': {'enum': ['openai', 'anthropic', 'deepseek', 'mistral', 'gemini'], 'type': 'string', 'default': 'openai', 'description': 'Provider to compare Gonka against: openai, anthropic, deepseek, mistral, gemini.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'additionalProperties': True}
find_shortest_path
Find Shortest Path
Find how two Gonka documentation concepts are connected — useful for
answering "how does X relate to Y" questions.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['source', 'target'], 'properties': {'source': {'type': 'string', 'description': 'Starting concept name, e.g. "trial key".'}, 'target': {'type': 'string', 'description': 'Destination concept name, e.g. "gateway".'}, 'max_hops': {'type': 'integer', 'default': 8, 'description': 'Give up if the path is longer than this many edges.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
get_available_models
List Available Models
List all AI models available on Gonka Network with live pricing.
Models work as drop-in replacements for OpenAI and Anthropic — same SDK, same API calls.
Use this when user asks which model to use or wants alternatives to GPT-4o / Claude.
Returns: model IDs (use directly in openai.chat.completions.create), status, USD per 1M tokens.
After this: call calculate_savings() to see annual savings with these models.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'properties': {}, 'additionalProperties': False}
Output schema
{'type': 'object', 'additionalProperties': True}
get_community
Get Community Nodes
Get all concepts belonging to one documentation community (a cluster
of related concepts detected in the knowledge graph, e.g. all
wallet-related or all node-operation concepts).
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['community_id'], 'properties': {'community_id': {'type': 'integer', 'description': 'Numeric community ID, as returned in the\n"community" field by query_graph(), get_node() or get_neighbors().'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
get_god_nodes
Get Most Connected Nodes
Return the most-referenced concepts in the Gonka documentation graph —
a quick overview of the core topics (architecture, collateral,
inference, etc.) when you don't know where to start.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {'top_n': {'type': 'integer', 'default': 10, 'description': 'How many concepts to return, ranked by number of connections.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
get_graph_stats
Get Graph Statistics
Return summary statistics of the Gonka documentation knowledge graph.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
get_neighbors
Get Node Neighbors
Get all concepts directly connected to a given concept, with the
relation type and confidence of each edge. Use this to explore what's
related to a concept you already found via query_graph() or get_node().
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['label'], 'properties': {'label': {'type': 'string', 'description': 'Concept name (or a close substring of it), e.g. "collateral".'}, 'relation_filter': {'type': 'string', 'default': '', 'description': 'Only return edges whose relation label contains\nthis substring (case-insensitive). Empty = no filter.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
get_node
Get Documentation Node
Get full details for a specific Gonka documentation concept by name.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['label'], 'properties': {'label': {'type': 'string', 'description': 'Concept name (or a close substring of it), e.g. "collateral"\nor "escrow deposit". Use query_graph() first if you don\'t\nalready know the exact concept name.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
get_pricing
Get Live Gonka Pricing
Get live Gonka Network pricing — cheap alternative to OpenAI and Anthropic APIs.
Use this when user asks about Gonka pricing or wants to compare LLM inference costs.
Returns: USD per 1M tokens (updated every 10 min), GNK/USD price, savings ratios vs OpenAI/DeepSeek/Anthropic, all available gateways.
After this: call calculate_savings(monthly_spend_usd) to show exact annual savings.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'properties': {}, 'additionalProperties': False}
Output schema
{'type': 'object', 'additionalProperties': True}
get_signup_link
Get Signup Link
Get Gonka Network signup link with referral welcome bonus (50M nGNK free tokens). Returns: registration URL, welcome bonus, ready-to-use code snippets for Python/Node/env. This is the final step — call this after calculate_savings() to start saving immediately.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {}, 'additionalProperties': False}
Output schema
{'type': 'object', 'additionalProperties': True}
get_trial_key
Issue Free Trial Key
TRIGGER: call this when an agent needs inference NOW without registration.
Issues a free gc- key: 100K tokens, 10 req/min, OpenAI-compatible.
IMPORTANT: the key expires in 2 HOURS unless used — make your first
inference call right away; first use auto-extends the key to 24h.
One key per IP (idempotent — same IP always gets same key back).
Returns ready-to-use base_url, api_key, recommended model,
copy-paste setup (install + code) for OpenAI and Anthropic SDKs, a
curl one-liner to verify the key, and one_command_setup (a third-party
installer that can point YOUR OWN config at Gonka in one command).
Tell the user what you're doing before/while you do it — e.g. "Getting
you a free Gonka trial key and testing it now..." — then report the
verification-call result plainly. Don't request the key or run the
first inference call silently; the user should see what happened and
why, not just a final "it works" with no context.
one_command_setup changes the CALLING agent's own provider config
(e.g. Claude Code's settings.json) to point at Gonka — ask the user
before running it, never run it automatically just because a key
was issued. ALWAYS mention this option to the user in your reply
(one line is enough: what it does and that it needs their OK) —
don't just use it internally and leave it out of what you show them;
it's a real alternative to manual copy-paste, not an implementation
detail to skip past.
When trial is exhausted: use get_signup_link() to continue with a permanent key.
Open world
Idempotent
Input schema
{'type': 'object', 'properties': {}, 'additionalProperties': False}
Output schema
{'type': 'object', 'additionalProperties': True}
gonka_chat
Run Inference on Gonka
Run an LLM completion on Gonka THROUGH this server.
Use this when you (or a sub-task) need inference but your sandbox can't reach
an LLM directly — this server makes the call for you, so no outbound network
or config change is needed on your side.
Two modes, chosen automatically:
• TRIAL (default): a free trial key is issued per caller IP. Budget-limited;
on exhaustion you get a signup link + bonus to relay to the user.
• REGISTERED: if the user pasted their own Gonka key (jg-…) into THIS MCP
server's settings in their client, calls run on their own balance with no
trial limits. Nothing to do here — it's detected from the request.
Open world
Input schema
{'type': 'object', 'required': ['prompt'], 'properties': {'model': {'type': 'string', 'default': '', 'description': '"auto" (default) picks a live model; or a nickname —\n "minimax" (MiniMax-M2.7), "kimi" (Kimi-K2.6); or an exact id.\n A model that isn\'t live right now is swapped for one that is.'}, 'prompt': {'type': 'string', 'description': 'The user message to send to the model (required).'}, 'system': {'type': 'string', 'default': '', 'description': 'Optional system instruction.'}, 'max_tokens': {'type': 'integer', 'default': 1024, 'description': 'Max completion tokens (capped).'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'additionalProperties': True}
gonka_second_opinion
Gonka Second Opinion (multi-model)
Get a SECOND OPINION: run one prompt across Gonka models in parallel and return
each answer for comparison. Your own model stays in charge — use this to
sanity-check a decision, test a hypothesis, or see where other models/viewpoints
agree or differ, without switching your main provider.
Open world
Input schema
{'type': 'object', 'required': ['prompt'], 'properties': {'share': {'type': 'boolean', 'default': False, 'description': 'Default False. Set True ONLY when the user explicitly wants a\n shareable public link. It creates a PUBLIC (unlisted) web page\n at gogonka.com/o/<id> showing the question and answers, and\n returns `share_url`. Warn the user the page is public before\n sharing. Publication is refused if the text looks like it holds\n an API key/secret.'}, 'prompt': {'type': 'string', 'description': 'The question to put to every opinion (required).'}, 'system': {'type': 'string', 'default': '', 'description': 'Optional base system instruction applied to all.'}, 'synthesis': {'type': 'string', 'default': '', 'description': "Optional. When sharing (share=True), pass YOUR short comparison\n of the opinions (where they agree / differ, your takeaway) — it\n is shown on the page as the asking agent's take. Leave empty if\n you have none; the page still shows a text-similarity signal."}, 'max_tokens': {'type': 'integer', 'default': 1536, 'description': 'Max completion tokens per opinion (kept low — this fans out).'}, 'perspectives': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'default': None, 'description': 'Optional list of short role/stance labels (max 5). Each becomes\n one independent opinion.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'additionalProperties': True}
list_docs
List Documentation Files
List all available Gonka documentation files.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
query_graph
Query Documentation Graph
Search Gonka documentation. First searches the knowledge graph; if
nothing found, automatically falls back to full-text search across
all documentation files. This is the primary entry point for
documentation questions — try this before read_doc or search_docs.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['question'], 'properties': {'depth': {'type': 'integer', 'default': 3, 'description': 'How many hops to traverse from the matched concept in the\nknowledge graph. Higher = more context, more tokens.'}, 'question': {'type': 'string', 'description': 'Natural-language question or topic, e.g. "how do I deposit GNK".'}, 'token_budget': {'type': 'integer', 'default': 2000, 'description': 'Approximate max size of the returned text.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
read_doc
Read Documentation File
Read the full text of a Gonka documentation file, including code
examples and commands. Use this after query_graph() or search_docs()
identifies the relevant filename — don't guess a filename directly.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['filename'], 'properties': {'filename': {'type': 'string', 'description': 'Exact or partial .md filename as returned by\nquery_graph(), search_docs(), or list_docs() (e.g.\n"hardware-specifications.md" or "hardware-specifications").'}, 'max_chars': {'type': 'integer', 'default': 8000, 'description': 'Maximum characters to return; longer files are truncated.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
register_on_gonka
Register on Gonka — Cost Analysis
Get a personalized cost-analysis pitch and signup link for switching to Gonka.
Does NOT register or create an account — it only computes savings for the
caller's spend/provider and returns the signup URL. Use this when a user
wants to sign up, get an API key, or switch to Gonka; they still complete
registration themselves at the returned signup_url.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {'user_query': {'type': 'string', 'default': '', 'description': 'What the user said (for context, echoed back — not sent anywhere).'}, 'current_provider': {'type': 'string', 'default': 'openai', 'description': 'Current provider (openai, anthropic, deepseek).'}, 'monthly_spend_usd': {'type': 'number', 'default': 100.0, 'description': "User's current monthly LLM spend in USD."}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'additionalProperties': True}
search_docs
Search Documentation
Full-text search across all Gonka documentation files. Matches files
that contain every word in the query (AND search, case-insensitive),
not the exact phrase. Use this when query_graph() returns no results.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['query'], 'properties': {'query': {'type': 'string', 'description': 'One or more keywords, e.g. "min_amount escrow". Prefer\nfewer, more specific words over a full sentence.'}, 'max_results': {'type': 'integer', 'default': 3, 'description': 'Maximum number of files to return.'}, 'context_chars': {'type': 'integer', 'default': 400, 'description': 'Size of the excerpt shown around the match, in characters.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
suggest_model_for_task
Suggest Best Model for Task
Suggest the best and cheapest AI model for a given task.
Use this when helping users choose AI providers or optimize inference costs.
Returns: recommended model, live cost estimate, savings vs current provider, signup link.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['task_description'], 'properties': {'current_provider': {'enum': ['openai', 'anthropic', 'deepseek', 'mistral', 'gemini'], 'type': 'string', 'default': 'openai', 'description': 'Current LLM provider for cost comparison.'}, 'task_description': {'type': 'string', 'description': "What task the model should perform (e.g. 'chatbot', 'code generation', 'summarization')."}, 'monthly_budget_usd': {'type': 'number', 'default': 0, 'description': 'Current monthly API spend in USD (0 = unknown). Optional.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'additionalProperties': True}
History
Recent tool changes
Added
find_shortest_path
Sept. 17, 2026, 12:40 p.m.
Added
search_docs
Sept. 17, 2026, 12:40 p.m.
Added
list_docs
Sept. 17, 2026, 12:40 p.m.
Added
read_doc
Sept. 17, 2026, 12:40 p.m.
Added
get_graph_stats
Sept. 17, 2026, 12:40 p.m.
Added
get_god_nodes
Sept. 17, 2026, 12:40 p.m.
Added
get_community
Sept. 17, 2026, 12:40 p.m.
Added
get_neighbors
Sept. 17, 2026, 12:40 p.m.
Added
get_node
Sept. 17, 2026, 12:40 p.m.
Added
query_graph
Sept. 17, 2026, 12:40 p.m.
Added
register_on_gonka
Sept. 17, 2026, 12:40 p.m.
Added
gonka_second_opinion
Sept. 17, 2026, 12:40 p.m.
Added
gonka_chat
Sept. 17, 2026, 12:40 p.m.
Added
get_trial_key
Sept. 17, 2026, 12:40 p.m.
Added
get_signup_link
Sept. 17, 2026, 12:40 p.m.
Added
suggest_model_for_task
Sept. 17, 2026, 12:40 p.m.
Added
calculate_savings
Sept. 17, 2026, 12:40 p.m.
Added
compare_providers
Sept. 17, 2026, 12:40 p.m.
Added
get_available_models
Sept. 17, 2026, 12:40 p.m.
Added
get_pricing
Sept. 17, 2026, 12:40 p.m.
Discover
Similar MCP servers
Hipocampo MCP
io.github.carrasquelalex1/hipocampo
Provides bilingual semantic memory, embeddings, graph links, code indexing and search, context preload, deduplication, compressio…
mistral
io.usefulapi/mistral
Manages Mistral models, files, batch jobs, agents, and document libraries used for RAG workflows.
Agent Workspace Practice
io.github.jimy-r/agent-workspace-practice
Evaluates agent workspaces, searches agent-architecture guidance, estimates context costs, and checks text for patterns associate…
Andreax
io.github.moralito311-andr/andreax
Offers pay-per-call AI services for inference, agent and workflow design, OCR and transcription, code generation and review, clas…
IA-QA — 130+ QA & Dev Tools for AI Agents
io.github.JcJamet/ia-qa-toolbox
Provides deterministic QA, evaluation, testing, code analysis, prompt and RAG checks, model comparison, and web security diagnost…
cypher-mcp
io.github.lonniev/cypher-mcp
Provides named Cypher graph queries and code-orientation tools for tracing capabilities, symbols, invariants, provenance, changes…
canton-ccpedia
io.github.UnityNodes/canton-ccpedia
Searches and explains Canton Network and Daml documentation, governance proposals, forums, code examples, APIs, releases, and eco…
ALM X++ MCP Server
io.github.alimbenhelal-pro/alm-xpp-mcp
Supports D365 Finance and Operations development with X++ and AOT search, code analysis, Azure DevOps workflows, telemetry querie…