Gonka Second Opinion (multi-model)

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.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

{
  "type": "object",
  "additionalProperties": true
}

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.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

{
  "type": "object",
  "additionalProperties": true
}

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.

{
  "type": "object",
  "properties": {
    "provider": {
      "default": "openai",
      "enum": [
        "openai",
        "anthropic",
        "deepseek",
        "mistral",
        "gemini"
      ],
      "type": "string",
      "description": "Provider to compare Gonka against: openai, anthropic, deepseek, mistral, gemini."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "additionalProperties": true
}

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.

{
  "type": "object",
  "properties": {
    "monthly_spend_usd": {
      "default": 100,
      "type": "number",
      "description": "Current monthly OpenAI/Anthropic API spend in USD. Default: $100/month."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "additionalProperties": true
}

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.

{
  "type": "object",
  "properties": {
    "task_description": {
      "type": "string",
      "description": "What task the model should perform (e.g. 'chatbot', 'code generation', 'summarization')."
    },
    "monthly_budget_usd": {
      "default": 0,
      "type": "number",
      "description": "Current monthly API spend in USD (0 = unknown). Optional."
    },
    "current_provider": {
      "default": "openai",
      "enum": [
        "openai",
        "anthropic",
        "deepseek",
        "mistral",
        "gemini"
      ],
      "type": "string",
      "description": "Current LLM provider for cost comparison."
    }
  },
  "required": [
    "task_description"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "additionalProperties": true
}

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.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

{
  "type": "object",
  "additionalProperties": true
}

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.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

{
  "type": "object",
  "additionalProperties": true
}

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.

{
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string",
      "description": "The user message to send to the model (required)."
    },
    "system": {
      "default": "",
      "type": "string",
      "description": "Optional system instruction."
    },
    "model": {
      "default": "",
      "type": "string",
      "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."
    },
    "max_tokens": {
      "default": 1024,
      "type": "integer",
      "description": "Max completion tokens (capped)."
    }
  },
  "required": [
    "prompt"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "additionalProperties": true
}

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.

{
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string",
      "description": "The question to put to every opinion (required)."
    },
    "system": {
      "default": "",
      "type": "string",
      "description": "Optional base system instruction applied to all."
    },
    "perspectives": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional list of short role/stance labels (max 5). Each becomes\n          one independent opinion."
    },
    "max_tokens": {
      "default": 1536,
      "type": "integer",
      "description": "Max completion tokens per opinion (kept low — this fans out)."
    },
    "share": {
      "default": false,
      "type": "boolean",
      "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."
    },
    "synthesis": {
      "default": "",
      "type": "string",
      "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."
    }
  },
  "required": [
    "prompt"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "additionalProperties": true
}

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.

{
  "type": "object",
  "properties": {
    "monthly_spend_usd": {
      "default": 100,
      "type": "number",
      "description": "User's current monthly LLM spend in USD."
    },
    "current_provider": {
      "default": "openai",
      "type": "string",
      "description": "Current provider (openai, anthropic, deepseek)."
    },
    "user_query": {
      "default": "",
      "type": "string",
      "description": "What the user said (for context, echoed back — not sent anywhere)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "additionalProperties": true
}

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.

{
  "type": "object",
  "properties": {
    "question": {
      "type": "string",
      "description": "Natural-language question or topic, e.g. \"how do I deposit GNK\"."
    },
    "depth": {
      "default": 3,
      "type": "integer",
      "description": "How many hops to traverse from the matched concept in the\nknowledge graph. Higher = more context, more tokens."
    },
    "token_budget": {
      "default": 2000,
      "type": "integer",
      "description": "Approximate max size of the returned text."
    }
  },
  "required": [
    "question"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "result": {
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "x-fastmcp-wrap-result": true
}

Get full details for a specific Gonka documentation concept by name.

{
  "type": "object",
  "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."
    }
  },
  "required": [
    "label"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "result": {
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "x-fastmcp-wrap-result": true
}

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().

{
  "type": "object",
  "properties": {
    "label": {
      "type": "string",
      "description": "Concept name (or a close substring of it), e.g. \"collateral\"."
    },
    "relation_filter": {
      "default": "",
      "type": "string",
      "description": "Only return edges whose relation label contains\nthis substring (case-insensitive). Empty = no filter."
    }
  },
  "required": [
    "label"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "result": {
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "x-fastmcp-wrap-result": true
}

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).

{
  "type": "object",
  "properties": {
    "community_id": {
      "type": "integer",
      "description": "Numeric community ID, as returned in the\n\"community\" field by query_graph(), get_node() or get_neighbors()."
    }
  },
  "required": [
    "community_id"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "result": {
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "x-fastmcp-wrap-result": true
}

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.

{
  "type": "object",
  "properties": {
    "top_n": {
      "default": 10,
      "type": "integer",
      "description": "How many concepts to return, ranked by number of connections."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "result": {
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "x-fastmcp-wrap-result": true
}

Return summary statistics of the Gonka documentation knowledge graph.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "result": {
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "x-fastmcp-wrap-result": true
}

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.

{
  "type": "object",
  "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": {
      "default": 8000,
      "type": "integer",
      "description": "Maximum characters to return; longer files are truncated."
    }
  },
  "required": [
    "filename"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "result": {
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "x-fastmcp-wrap-result": true
}

List all available Gonka documentation files.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "result": {
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "x-fastmcp-wrap-result": true
}

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.

{
  "type": "object",
  "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": {
      "default": 3,
      "type": "integer",
      "description": "Maximum number of files to return."
    },
    "context_chars": {
      "default": 400,
      "type": "integer",
      "description": "Size of the excerpt shown around the match, in characters."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "result": {
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "x-fastmcp-wrap-result": true
}

Find how two Gonka documentation concepts are connected — useful for answering "how does X relate to Y" questions.

{
  "type": "object",
  "properties": {
    "source": {
      "type": "string",
      "description": "Starting concept name, e.g. \"trial key\"."
    },
    "target": {
      "type": "string",
      "description": "Destination concept name, e.g. \"gateway\"."
    },
    "max_hops": {
      "default": 8,
      "type": "integer",
      "description": "Give up if the path is longer than this many edges."
    }
  },
  "required": [
    "source",
    "target"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "result": {
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "x-fastmcp-wrap-result": true
}