{"_id":"@aisearchindex/mcp","name":"@aisearchindex/mcp","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@aisearchindex/mcp","version":"1.0.0","description":"MCP server for querying AI Search Index analytics data","main":"dist/index.js","bin":{"aisearchindex-mcp":"dist/index.js"},"type":"module","scripts":{"build":"tsc","dev":"tsc --watch","start":"node dist/index.js","prepublishOnly":"npm run build"},"keywords":["mcp","model-context-protocol","ai-search-index","analytics","ai-bots"],"author":{"name":"AI Search Index"},"license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^0.6.0"},"devDependencies":{"@types/node":"^20.10.0","typescript":"^5.3.0"},"engines":{"node":">=18.0.0"},"repository":{"type":"git","url":"git+https://github.com/aisearchindex/ai-search-index.git"},"publishConfig":{"access":"public"},"_id":"@aisearchindex/mcp@1.0.0","gitHead":"11992d3e6559183b5adc8146e1caeb559c1a1192","types":"./dist/index.d.ts","bugs":{"url":"https://github.com/aisearchindex/ai-search-index/issues"},"homepage":"https://github.com/aisearchindex/ai-search-index#readme","_nodeVersion":"20.18.0","_npmVersion":"11.4.2","dist":{"integrity":"sha512-Yxb+aji8Dt/4qJhOKQVjTT7IEn2OvNim0kFKK7dpcLDav2mmObkWsWBT0yvXciHAzHOCjs7ON5PBJ3Z1SiAZHQ==","shasum":"1356a27a0b15cae8c289d79bddbf0fa6ed4e9706","tarball":"https://registry.npmjs.org/@aisearchindex/mcp/-/mcp-1.0.0.tgz","fileCount":7,"unpackedSize":40584,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIEwEtqlCZNvxwN4ldsMaMZpfR0DfpbOzPREyzFZcYiA7AiEAlkPelkTCEB/oSTAzwpZ9WMCZ8vcrv0pPp5AX9jQj8oI="}]},"_npmUser":{"name":"ihmissuti","email":"kimmo@superlines.io"},"directories":{},"maintainers":[{"name":"ihmissuti","email":"kimmo@superlines.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_1.0.0_1767945744553_0.02517989646304386"},"_hasShrinkwrap":false}},"time":{"created":"2026-01-09T08:02:24.506Z","1.0.0":"2026-01-09T08:02:24.677Z","modified":"2026-01-09T08:02:24.922Z"},"maintainers":[{"name":"ihmissuti","email":"kimmo@superlines.io"}],"description":"MCP server for querying AI Search Index analytics data","homepage":"https://github.com/aisearchindex/ai-search-index#readme","keywords":["mcp","model-context-protocol","ai-search-index","analytics","ai-bots"],"repository":{"type":"git","url":"git+https://github.com/aisearchindex/ai-search-index.git"},"author":{"name":"AI Search Index"},"bugs":{"url":"https://github.com/aisearchindex/ai-search-index/issues"},"license":"MIT","readme":"# AI Search Index MCP Server\n\nA Model Context Protocol (MCP) server that allows AI assistants like Claude, ChatGPT, and others to query your AI Search Index analytics data directly.\n\n## Features\n\n- **List Websites**: View all tracked websites in your account\n- **Get Analytics**: Comprehensive analytics including bot vs human traffic\n- **Bot Breakdown**: Detailed breakdown of which AI bots are crawling your site\n- **Daily Trends**: Traffic trends over time with visual graphs\n- **Quick Summary**: Fast overview of traffic metrics\n\n## Prerequisites\n\n- Node.js 18 or higher\n- An AI Search Index account with an API key\n- A MCP-compatible client (Claude Desktop, Cursor, etc.)\n\n## Getting Your API Key\n\n1. Log in to [AI Search Index](https://aisearchindex.com/dashboard)\n2. Go to **API Keys** in the sidebar\n3. Click **Create API Key**\n4. Copy the generated key (starts with `sk_live_`)\n\n> ⚠️ **Important**: Save your API key securely. It's only shown once!\n\n## Installation\n\n### Option 1: Install from npm (Recommended)\n\n```bash\nnpm install -g aisearchindex-mcp\n```\n\n### Option 2: Install from source\n\n```bash\ngit clone https://github.com/aisearchindex/ai-search-index\ncd ai-search-index/packages/aisearchindex-mcp\nnpm install\nnpm run build\n```\n\n## Configuration\n\n### Claude Desktop\n\nAdd to your Claude Desktop configuration file:\n\n**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n\n**Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"aisearchindex\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"aisearchindex-mcp\"],\n      \"env\": {\n        \"AISEARCHINDEX_API_KEY\": \"sk_live_your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n### Cursor\n\nAdd to your Cursor MCP settings (Settings → Features → MCP Servers):\n\n```json\n{\n  \"mcpServers\": {\n    \"aisearchindex\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"aisearchindex-mcp\"],\n      \"env\": {\n        \"AISEARCHINDEX_API_KEY\": \"sk_live_your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n### VS Code with Continue\n\nAdd to your Continue configuration (`~/.continue/config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"aisearchindex\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"aisearchindex-mcp\"],\n      \"env\": {\n        \"AISEARCHINDEX_API_KEY\": \"sk_live_your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n### Using Local Installation\n\nIf you installed from source or locally, use the full path:\n\n```json\n{\n  \"mcpServers\": {\n    \"aisearchindex\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/aisearchindex-mcp/dist/index.js\"],\n      \"env\": {\n        \"AISEARCHINDEX_API_KEY\": \"sk_live_your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n## Available Tools\n\nOnce configured, you can ask your AI assistant to use these tools:\n\n### `list_websites`\n\nLists all websites tracked in your AI Search Index account.\n\n**Example prompts:**\n- \"Show me my tracked websites\"\n- \"What websites am I tracking?\"\n\n### `get_analytics`\n\nGets comprehensive analytics for a specific website.\n\n**Parameters:**\n- `website_id` (required): The website UUID\n- `start_date` (optional): Start date (YYYY-MM-DD)\n- `end_date` (optional): End date (YYYY-MM-DD)\n\n**Example prompts:**\n- \"Get analytics for my website\"\n- \"Show me traffic data for the last 7 days\"\n\n### `get_bot_breakdown`\n\nShows which bots are crawling your site, categorized by type (AI crawlers, search engines, etc.).\n\n**Parameters:**\n- `website_id` (required): The website UUID\n- `start_date` (optional): Start date (YYYY-MM-DD)\n- `end_date` (optional): End date (YYYY-MM-DD)\n\n**Example prompts:**\n- \"Which AI bots are crawling my site?\"\n- \"Show me the bot breakdown for my website\"\n\n### `get_daily_trends`\n\nDisplays daily traffic trends with visual representation.\n\n**Parameters:**\n- `website_id` (required): The website UUID\n- `start_date` (optional): Start date (YYYY-MM-DD)\n- `end_date` (optional): End date (YYYY-MM-DD)\n\n**Example prompts:**\n- \"Show me daily traffic trends\"\n- \"How has my bot traffic changed over time?\"\n\n### `get_summary`\n\nQuick overview of traffic metrics.\n\n**Parameters:**\n- `website_id` (required): The website UUID\n- `start_date` (optional): Start date (YYYY-MM-DD)\n- `end_date` (optional): End date (YYYY-MM-DD)\n\n**Example prompts:**\n- \"Give me a quick summary of my traffic\"\n- \"How many bot visits did I get this month?\"\n\n## Example Conversation\n\nHere's an example of how you might interact with the MCP server through Claude:\n\n**You:** What websites am I tracking with AI Search Index?\n\n**Claude:** Let me check your tracked websites.\n\n📊 example.com\n   ID: 550e8400-e29b-41d4-a716-446655440000\n   URL: https://example.com\n   Tracking ID: tid_abc123\n   Created: 12/15/2024\n\n**You:** Which AI bots are crawling example.com?\n\n**Claude:** Let me get the bot breakdown for your website.\n\n🤖 Bot Breakdown (2024-11-24 to 2024-12-24)\n──────────────────────────────────────────────────\n\nTotal Bot Visits: 15,432\n\n🧠 AI Crawlers:\n   GPTBot: 5,234 visits (33.9%)\n   ClaudeBot: 3,122 visits (20.2%)\n   PerplexityBot: 2,456 visits (15.9%)\n\n🔍 Search Engine Bots:\n   Googlebot: 2,890 visits (18.7%)\n   Bingbot: 1,234 visits (8.0%)\n\n## Troubleshooting\n\n### \"AISEARCHINDEX_API_KEY environment variable is required\"\n\nMake sure your API key is properly set in your MCP client configuration. The key should start with `sk_live_`.\n\n### \"Invalid API key\"\n\n1. Verify your API key is correct (no extra spaces)\n2. Check that the key hasn't expired\n3. Make sure you're using an API key, not a Bot Tracking Key\n\n### \"Website not found\"\n\nThe website_id must be a valid UUID for a website you own. Use `list_websites` first to get the correct ID.\n\n### Connection Issues\n\nIf the MCP server isn't connecting:\n\n1. Restart your MCP client (Claude Desktop, Cursor, etc.)\n2. Check that Node.js 18+ is installed: `node --version`\n3. Verify the configuration file syntax is valid JSON\n4. Check logs for error messages\n\n### Testing the Server Manually\n\nYou can test the MCP server directly:\n\n```bash\nexport AISEARCHINDEX_API_KEY=sk_live_your_key_here\nnpx aisearchindex-mcp\n```\n\nIf installed from source:\n\n```bash\ncd packages/aisearchindex-mcp\nnpm run build\nAISEARCHINDEX_API_KEY=sk_live_your_key_here node dist/index.js\n```\n\n## Environment Variables\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `AISEARCHINDEX_API_KEY` | Yes | - | Your API key from AI Search Index |\n| `AISEARCHINDEX_API_URL` | No | `https://aisearchindex.com` | API base URL (for self-hosted) |\n\n## Security Notes\n\n- **Never commit your API key** to version control\n- Use environment variables or secure secret management\n- API keys have read access to your analytics data\n- Rotate keys periodically for security\n\n## Support\n\n- **Documentation**: [aisearchindex.com/docs](https://aisearchindex.com/docs)\n- **FAQ**: [aisearchindex.com/faq](https://aisearchindex.com/faq)\n- **Contact**: [aisearchindex.com/contact](https://aisearchindex.com/contact)\n\n## License\n\nMIT License - see [LICENSE](LICENSE) for details.\n","readmeFilename":"README.md","_rev":"1-30db4f60293470ea9cde5f219f5fca64"}