{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_2gkvqev6muen","handle":"mcp-server-googlesearch","url":"https://wellknown.network/agents/mcp-server-googlesearch","links":{"self":"https://wellknown.network/agents/mcp-server-googlesearch/record.json","html":"https://wellknown.network/agents/mcp-server-googlesearch","markdown":"https://wellknown.network/agents/mcp-server-googlesearch/record.md","api":"https://wellknown.network/api/v1/agents/mcp-server-googlesearch","status":"https://wellknown.network/api/v1/agents/mcp-server-googlesearch/status","claim":"https://wellknown.network/agents/mcp-server-googlesearch/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-server-googlesearch/claim.json","badge":"https://wellknown.network/agents/mcp-server-googlesearch/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-server-googlesearch/history","tools":"https://wellknown.network/api/v1/agents/mcp-server-googlesearch/tools"},"ard":{"identifier":"urn:air::server:mcp-server-googlesearch","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-server-googlesearch","summary":"A Model Context Protocol server that provides Google search functionality to AI assistants","description":"# mcp-server-googlesearch MCP server\n\nA Model Context Protocol (MCP) server that provides Google search functionality to AI assistants. This server allows AI assistants like Claude to perform web searches and receive structured results with titles, URLs, and descriptions.\n\n## Features\n\n- **Google Search Tool**: Perform web searches using Google's search engine\n- **Structured Results**: Returns search results with title, URL, and description\n- **Configurable Results**: Specify the number of results (1-50, default: 10)\n- **Error Handling**: Comprehensive error handling for network issues, rate limiting, and validation\n- **MCP Protocol**: Full compliance with Model Context Protocol standards\n\n## Components\n\n### Tools\n\nThe server implements one tool:\n\n- **google_search**: Performs a Google search and returns structured results\n  - **query** (required): The search query to execute\n  - **num_results** (optional): Number of search results to return (1-50, default: 10)\n\n## Installation\n\n### Prerequisites\n\n- Python 3.11 or higher\n- uv package manager\n\n### Install from PyPI (when published)\n\n```bash\nuvx mcp-server-googlesearch\n```\n\n### Install from Source\n\n1. Clone or download the project\n2. Navigate to the project directory\n3. Build and install:\n\n```bash\ncd mcp-server-googlesearch\nuv sync\nuv build\nuv tool install dist/mcp_server_googlesearch-0.1.0-py3-none-any.whl\n```\n\n## Configuration\n\n### Claude Desktop\n\nAdd the following to your Claude Desktop configuration file:\n\n**Windows**: `%APPDATA%/Claude/claude_desktop_config.json`\n**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n\n#### For Published Version\n\n```json\n{\n  \"mcpServers\": {\n    \"google-search\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mcp-server-googlesearch\"]\n    }\n  }\n}\n```\n\n#### For Development/Local Installation\n\n```json\n{\n  \"mcpServers\": {\n    \"google-search\": {\n      \"command\": \"uvx\",\n      \"args\": [\n        \"--directory\",\n        \"C:\\\\path\\\\to\\\\mcp-server-googlesearch\",\n        \"mcp-…","publisher":null,"homepage":null,"repository":null,"version":"0.1.1","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:mcp-server-googlesearch","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"data.web-search","name":"Web Search","confidence":1,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"}],"categories":["data","dev"],"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-server-googlesearch","registry":"pypi","observedAt":"2026-10-28T13:24:51.620Z","publishedAt":"2025-07-22T11:34:00.365611Z","latestVersion":"0.1.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-server-googlesearch","url":"https://pypi.org/project/mcp-server-googlesearch/","firstSeenAt":"2026-09-10T03:20:37.947Z","fetchedAt":"2026-10-28T13:23:44.960Z","normalizedAt":"2026-10-28T13:23:44.960Z"}]},"firstSeenAt":"2026-09-10T03:20:37.947Z","updatedAt":"2026-10-28T13:24:51.620Z"}