grokbot.tools

Search the grokbot.tools directory of MCP connectors and plugins for Grok Bot by name, service or category, with optional filters (Grok Bot test status, install method, auth type). Returns compact summaries with the install method, auth type, honest test-status label and the grokbot.tools page URL; use get_connector for install steps and the MCP URL. Only published directory entries are returned. Read-only; independent fan project, not affiliated with xAI.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Free text matched against connector name, service, category and slug, e.g. 'notion' or 'payments'.",
      "type": "string",
      "maxLength": 80
    },
    "category": {
      "description": "Exact category name, case-insensitive, e.g. 'Developer tools & data', 'Money', 'Design', 'Docs & search', 'Projects & docs', 'Sales & support', 'Files', 'Security'. Use list_connectors with no filters to see categories in use.",
      "type": "string",
      "maxLength": 60
    },
    "status": {
      "description": "Grok Bot test status. 'verified' = dated test inside Grok Bot. 'seen_working' = seen working, dated re-test pending. 'unknown' = not re-tested inside Grok Bot yet (includes seen_working). 'broken' = failed when tried.",
      "type": "string",
      "enum": [
        "verified",
        "seen_working",
        "unknown",
        "broken"
      ]
    },
    "install_method": {
      "description": "How the app gets into Grok Bot: built-in plugin (Connect apps), custom MCP URL added via chat, browser only, or unverified.",
      "type": "string",
      "enum": [
        "plugin",
        "custom_mcp",
        "browser_only",
        "unknown"
      ]
    },
    "auth_type": {
      "description": "'oauth' = you sign in with your own account; 'public' = no sign-in.",
      "type": "string",
      "enum": [
        "oauth",
        "public"
      ]
    },
    "limit": {
      "description": "Max results, 1-25 (default 10). Larger values are clamped to 25.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Get the full public record for one published connector by its slug (the last part of https://grokbot.tools/connectors/{slug}): summary, install method with step-by-step instructions and sources, MCP URL (null for built-in plugins), auth type, docs link, Grok Bot test status with the last test date, notes, related wishlist requests, and the page URL. Status is never 'Verified' unless it was verified inside Grok Bot with a dated test. Read-only.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80,
      "description": "Connector slug, e.g. 'notion', 'linear', 'context7'. Find slugs with search_connectors."
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Page through every published connector in the grokbot.tools directory, alphabetically, with the same optional filters as search_connectors. Returns compact summaries plus the total, the categories in use (first page), and a next_cursor to pass back for the next page. Use this when you want the whole directory; use search_connectors when you know what you are looking for. Read-only.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Optional free-text filter on name, service, category and slug.",
      "type": "string",
      "maxLength": 80
    },
    "category": {
      "description": "Exact category name, case-insensitive, e.g. 'Developer tools & data', 'Money', 'Design', 'Docs & search', 'Projects & docs', 'Sales & support', 'Files', 'Security'. Use list_connectors with no filters to see categories in use.",
      "type": "string",
      "maxLength": 60
    },
    "status": {
      "description": "Grok Bot test status. 'verified' = dated test inside Grok Bot. 'seen_working' = seen working, dated re-test pending. 'unknown' = not re-tested inside Grok Bot yet (includes seen_working). 'broken' = failed when tried.",
      "type": "string",
      "enum": [
        "verified",
        "seen_working",
        "unknown",
        "broken"
      ]
    },
    "install_method": {
      "description": "How the app gets into Grok Bot: built-in plugin (Connect apps), custom MCP URL added via chat, browser only, or unverified.",
      "type": "string",
      "enum": [
        "plugin",
        "custom_mcp",
        "browser_only",
        "unknown"
      ]
    },
    "auth_type": {
      "description": "'oauth' = you sign in with your own account; 'public' = no sign-in.",
      "type": "string",
      "enum": [
        "oauth",
        "public"
      ]
    },
    "limit": {
      "description": "Page size, 1-50 (default 20). Larger values are clamped to 50.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "cursor": {
      "description": "Opaque cursor from a previous result's next_cursor. Omit for the first page.",
      "type": "string",
      "maxLength": 24
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List the grokbot.tools wishlist: apps people want connected to Grok Bot, sorted by on-site votes or by newest. Each item has its status (requested, claimed, live), on-site vote count, the labeled seed signal ('X buzz (seed)', mentions elsewhere that are never counted as votes), a linked connector if one exists, and its page URL. Votes are only votes made on grokbot.tools and start at 0. Read-only.

{
  "type": "object",
  "properties": {
    "sort": {
      "description": "'votes' = most on-site votes first, then seed buzz (default). 'recent' = newest first.",
      "type": "string",
      "enum": [
        "votes",
        "recent"
      ]
    },
    "status": {
      "description": "Only requests in this state. 'live' means a connector exists. Omit for all.",
      "type": "string",
      "enum": [
        "requested",
        "claimed",
        "live"
      ]
    },
    "limit": {
      "description": "Max results, 1-25 (default 10). Larger values are clamped to 25.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Get one wishlist request by slug (the last part of https://grokbot.tools/requests/{slug}): status, on-site votes, the labeled seed signal, description, public sources (links to the posts it came from), the linked connector if one exists, the builder if it has been claimed, and a matching setup guide when there is one. Slugs of requests that were merged resolve to the surviving request. Read-only.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80,
      "description": "Request slug, e.g. 'whatsapp'. Find slugs with list_requests."
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Explains how an app gets into Grok Bot: built-in plugins (Connect apps in the sidebar), custom MCP servers (you ask the Bot in chat to add a URL; must be public HTTPS using streamable HTTP or SSE), and the browser-only route when neither exists. Includes this server's own URL as a worked example. Takes no input and reads nothing from the database.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}