Skip to main content
Glama
grok-native-search-mcp

grok-native-search-mcp

by zuozh11

Grok Native Search MCP

A minimal stdio MCP Server providing three read-only tools:

  • web_search(query): Grok native Web Search

  • x_search(query): Grok native X Search

  • web_fetch(url): Jina Reader web page to Markdown

Search always uses grok-4.6, reasoning.effort: low, and max_turns: 1. Complementary searches may run in parallel within a single turn, stopping once enough first-hand evidence is found, and expanding scope only when evidence is missing or conflicting. Tool responses are not parsed or rewritten; they are returned directly as MCP text.

Tool routing: use web_fetch for known URLs or when page content needs verification; use x_search for X posts, accounts, threads, and trends; use web_search for other web-wide searches without a specific URL. After a search returns an external URL that needs verification, continue by calling web_fetch.

Environment Variables

Variable

Purpose

XAI_API_KEY

API Key for xAI or a compatible gateway

XAI_BASE_URL

Optional, Responses API base URL; defaults to https://aiapiv2.kamipon.com:442/v1

JINA_API_KEY

Jina Reader API Key

HTTP_PROXY / HTTPS_PROXY / NO_PROXY

Optional, environment proxy configuration used only for Jina Reader requests

Related MCP server: Ollama Web Search

Start with npx

npx -y grok-native-search-mcp@latest

Codex Configuration

[mcp_servers.grok_native_search]
command = "npx"
args = ["-y", "grok-native-search-mcp@latest"]
env_vars = ["XAI_API_KEY", "JINA_API_KEY", "HTTP_PROXY", "HTTPS_PROXY", "NO_PROXY"]

Restart Codex after configuration.

Local Development

npm install
npm test

Available Tools

3 tools
web_fetchA
Read-only

Use this when an exact HTTP(S) URL is known, including URLs returned by web_search or x_search, and the task is to read, quote, summarize, or verify page text. Prefer it over Browser, curl, or shell when no login, click, form interaction, or visual inspection is required. Do not use it to discover URLs. Returns raw Markdown from Jina Reader.

Inputs: url (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.6/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: web_search for general web discovery, x_search specifically for X content, and web_fetch for retrieving a known URL. The descriptions explicitly cross-reference each other (e.g., web_search notes 'For X-only content use x_search'), leaving no ambiguity about which tool to select.

    Naming Consistency5/5

    All three tool names follow a consistent `[source]_[action]` pattern: web_search, x_search, web_fetch. The naming convention is uniform, predictable, and immediately conveys scope (web vs. x) and operation (search vs. fetch).

    Tool Count5/5

    With only 3 tools, the server is tightly scoped for its purpose: general web search, X-specific search, and URL fetching. This is well within the ideal 3–15 range and every tool earns its place; adding more would likely introduce redundancy.

    Completeness5/5

    The surface covers the full lifecycle of a search task: discover sources (web_search, x_search) and then retrieve/verify content (web_fetch). The tools explicitly reference each other to create a complete workflow, with no obvious gaps for the stated domain.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables real-time web search via DeepSeek's search-enhanced dialogue, providing search results as answers through MCP tools.
      1
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables web search and web fetch operations using Ollama's hosted APIs, allowing MCP clients to search the web and retrieve page content.
      2
      34 PyPI
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables web search, page fetching and cleaning, OCR from images, and broken-link checking through MCP tools, with multi-provider aggregation, caching, and anti-detection features.
      35 npm
      MIT