{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_zzz27buyuhwu","handle":"mcp-grok-websearch","url":"https://wellknown.network/agents/mcp-grok-websearch","links":{"self":"https://wellknown.network/agents/mcp-grok-websearch/record.json","html":"https://wellknown.network/agents/mcp-grok-websearch","markdown":"https://wellknown.network/agents/mcp-grok-websearch/record.md","api":"https://wellknown.network/api/v1/agents/mcp-grok-websearch","status":"https://wellknown.network/api/v1/agents/mcp-grok-websearch/status","claim":"https://wellknown.network/agents/mcp-grok-websearch/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-grok-websearch/claim.json","badge":"https://wellknown.network/agents/mcp-grok-websearch/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-grok-websearch/history","tools":"https://wellknown.network/api/v1/agents/mcp-grok-websearch/tools"},"ard":{"identifier":"urn:air::server:mcp-grok-websearch","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-grok-websearch","summary":"MCP server that exposes Grok Build CLI's built-in web_search as an MCP tool","description":"# mcp-grok-websearch\n\nAn MCP server that exposes [Grok Build CLI](https://x.ai/cli)'s built-in `web_search` as a standard MCP tool. Any MCP-compatible agent (Codex, Claude Desktop, Cursor, etc.) can use it for real-time web search.\n\n## Prerequisites\n\n1. **Grok Build CLI** installed and authenticated:\n   ```bash\n   curl -fsSL https://x.ai/cli/install.sh | bash\n   grok login   # OAuth, or set GROK_CODE_XAI_API_KEY below\n   ```\n2. **uv** (for `uvx` usage): https://docs.astral.sh/uv/\n\n## Usage\n\n### Run directly with uvx (no install needed)\n\n```bash\nuvx mcp-grok-websearch\n```\n\n### Configure in an MCP-compatible agent\n\nAdd to your agent's MCP config (e.g. `~/.codex/config.json`, `claude_desktop_config.json`, etc.):\n\n```json\n{\n  \"mcpServers\": {\n    \"websearch\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mcp-grok-websearch\"]\n    }\n  }\n}\n```\n\nIf you use an API key instead of `grok login`:\n\n```json\n{\n  \"mcpServers\": {\n    \"websearch\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mcp-grok-websearch\"],\n      \"env\": {\n        \"GROK_CODE_XAI_API_KEY\": \"xai-...\"\n      }\n    }\n  }\n}\n```\n\n## MCP Tool\n\n### `web_search`\n\nSearch the web in real time using Grok's built-in search capability.\n\n| Parameter | Type | Default | Description |\n|---|---|---|---|\n| `query` | `str` | required | Search query |\n| `max_results` | `int` | `5` | Number of results (1–20) |\n\n**Returns:** Formatted results, each with `Title`, `URL`, and `Summary`, separated by `---`.\n\n**Example result:**\n```\nTitle: Model Context Protocol – Anthropic\nURL: https://modelcontextprotocol.io\nSummary: The official site for MCP, the open standard for connecting AI to external tools and data sources.\n---\nTitle: MCP GitHub Repository\nURL: https://github.com/modelcontextprotocol\nSummary: Source code and SDKs for the Model Context Protocol.\n---\n```\n\n## Authentication\n\nThe server supports two modes, tried in this order:\n\n1. **API key** – set `GROK_CODE_XAI_API_KEY` (or `XAI_API_KEY`) in the environment.\n2. **OAuth session** – if no key i…","publisher":null,"homepage":"https://github.com/Epiphany_LX/mcp-grok-websearch","repository":"https://github.com/Epiphany_LX/mcp-grok-websearch","version":"0.1.2","license":"MIT","protocols":["mcp"],"tags":["grok","llm","mcp","model-context-protocol","web-search","xai"],"pricing":null,"endpoints":[{"url":"pypi:mcp-grok-websearch","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"data.web-search","name":"Web Search","confidence":1,"provenance":"declared"},{"slug":"security.identity","name":"Identity & Access","confidence":0.836,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.825,"provenance":"derived"}],"categories":["data","dev","security"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"mcp-grok-websearch","registry":"pypi","observedAt":"2026-10-28T11:27:22.117Z","publishedAt":"2026-07-17T13:15:12.588099Z","latestVersion":"0.1.2"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-grok-websearch","url":"https://pypi.org/project/mcp-grok-websearch/","firstSeenAt":"2026-09-10T01:21:29.452Z","fetchedAt":"2026-10-28T11:26:18.639Z","normalizedAt":"2026-10-28T11:26:18.639Z"}]},"firstSeenAt":"2026-09-10T01:21:29.452Z","updatedAt":"2026-10-28T11:27:22.117Z"}