Overview

Server Tools are GonkaGate-operated tools that a model can use during a POST /v1/chat/completions request. Add them to the OpenAI-compatible tools array with the gonkagate: prefix. Your application does not need to implement the tool callback.

Available tools

How it works

1. Include one or more GonkaGate server tools in tools.
2. Send the request to https://api.gonkagate.com/v1/chat/completions as a normal chat-completions call.
3. GonkaGate executes the server tool when it is needed and passes the result back to the model.
4. The final response is returned in the usual choices[0].message.content field.

Server tools can be used next to normal user-defined function tools. GonkaGate executes only the gonkagate:* tools. Your application still handles your own function tools.

Quick start

export GONKAGATE_API_KEY="gp-your-api-key"

curl https://api.gonkagate.com/v1/chat/completions \
  -H "Authorization: Bearer $GONKAGATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen/qwen3-235b-a22b-instruct-2507-fp8",
    "messages": [
      {
        "role": "user",
        "content": "What changed in AI this week, and what day is it in New York?"
      }
    ],
    "tools": [
      { "type": "gonkagate:web_search" },
      {
        "type": "gonkagate:datetime",
        "parameters": { "timezone": "America/New_York" }
      }
    ]
  }'

Server Tools vs Plugins vs User-Defined Tools

Plugins remain supported. Use Server Tools when you want the model to decide whether to use a GonkaGate-operated tool during a request. Use plugins when you need plugin-specific request fields or saved plugin settings.

Compatibility notes

• Server tool types must use the gonkagate: prefix.
• gonkagate:web_search uses existing GonkaGate web-search behavior and does not accept request-level server-tool parameters.
• gonkagate:web_fetch supports non-streaming chat completions only. Do not use it with stream: true.
• If you combine gonkagate:web_fetch with your own function tools, the model must not call Web Fetch and your function tool in the same assistant turn.
• gonkagate:datetime works by adding the current datetime context before the model response.

See also

• Web Search for current information.
• Web Fetch for reading public URLs.
• Datetime for timezone-aware current time.
• Tool Calling for user-defined function tools.
• Chat Completions API reference for the full request schema.