Grok

Use Thirdfy MCP from xAI Grok with remote MCP tools in the xAI Responses API and the xai-sdk.

Use Thirdfy from Grok so it can read markets and act for your agent. To use it in the Grok app with a connector and sign-in, follow Use Thirdfy in Grok. This page covers the xAI API.

You add Thirdfy to the tools of an xAI API request, and xAI handles the connection. See xAI's Remote MCP tools docs.

You need a Thirdfy agent API key (agent-...) for any tool that acts for your agent. To get one, run email onboarding once through any MCP client or with the Agent CLI.

Request

Put your agent key in authorization. Thirdfy receives it in the Authorization header.

xai-sdk
curl
import os

from xai_sdk import Client
from xai_sdk.chat import user
from xai_sdk.tools import mcp

client = Client(api_key=os.environ["XAI_API_KEY"])

chat = client.chat.create(
    model="grok-4.7",
    tools=[
        mcp(
            server_url="https://mcp.thirdfy.com/mcp",
            server_label="thirdfy",
            authorization=os.environ["AGENT_API_KEY"],
            allowed_tool_names=["getProviderActions", "getVenueReadiness", "agentRun"],
        ),
    ],
)

chat.append(user("Using Thirdfy, read the latest BTC funding on Hyperliquid."))
print(chat.sample().content)

Keep writes under control

xAI runs MCP tool calls without asking you first; it does not support require_approval. So limit what Grok can do in two places:

  • allowed_tools (allowed_tool_names in the xai-sdk). List only the tools the task needs. Without it, every Thirdfy tool is loaded, which also fills up the model's context.
  • Your agent's policy in Thirdfy. The key's action allowlist and daily limit apply to every call, whatever the model asks for. See Delegation & protection.

For a research agent, allow only getActionsCatalog, getProviderActions and agentRun, and ask it to run read actions such as the get_openmarket_* and get_cmc_* reads.

Troubleshooting

IssueFix
401 Authentication requiredPass the agent key in authorization
Grok calls a tool you didn't expectNarrow allowed_tools, and the key's action allowlist
AGENT_IDENTITY_MISMATCHThe model passed a different key in arguments. The bearer key is used

Related

OpenAI
Use Thirdfy MCP from OpenAI. The Responses API remote MCP tool, Codex, and ChatGPT developer mode.
OpenClaw and Hermes
Thirdfy MCP from OpenClaw and Hermes runtimes. Connector config, the agent key in a header, and executionContext on writes.