aisearchapi-mcp
v1.0.5
Published
Model Context Protocol server for AI Search API - Provides intelligent search capabilities with context awareness and semantic understanding
Maintainers
Readme
🤖 AI Search API MCP Server
A Model Context Protocol (MCP) server that integrates the AI Search API into MCP-compatible apps.
Bring semantic search, context awareness, and source citations directly into your AI workflows.
👉 Get started now:
- 🆕 Sign Up
- 🔑 Log In
- 📊 Dashboard (manage your API key)
✨ Features
- 🔍 Intelligent Semantic Search – Natural language search with embeddings
- 💬 Context Management – Keep or clear conversation history
- 📝 Flexible Responses – Markdown or plain text output
- 📚 Source Citations – Reliable references included
- 📊 Balance Monitoring – Track credits in real time
- ⚡ TypeScript Support – Strong typing & IDE hints
📦 Installation
From npm (recommended):
npm install -g aisearchapi-mcpFrom source:
git clone https://github.com/aisearchapi/aisearchapi-mcp.git
cd aisearchapi-mcp
npm install
npm run build🔑 Configuration
1. Get API Key
Create your account and copy your key:
2. Environment Variables
.env file:
AISEARCHAPI_KEY=your-api-key-here
AISEARCHAPI_BASE_URL=https://api.aisearchapi.io
AISEARCHAPI_TIMEOUT=30000
AISEARCHAPI_VERBOSE=false🛠️ Configure Claude for Desktop
npm install -g @anthropic-ai/claude-codeAuthorize Claude Code, then add the MCP:
claude mcp add aisearchapi "npx -y aisearchapi-mcp" --env API_KEY=<YOUR-API-KEY>Check:
claude mcp list
# aisearchapi: npx -y aisearchapi-mcp - ✓ Connected💻 Command Line Usage
node dist/index.js --list-tools
node dist/index.js --check-balance
node dist/index.js⚠️ Error Codes
| Code | Meaning | Fix | |------|---------|-----| | 401 | Unauthorized | Invalid key → Get key | | 429 | Too Many Requests | Add retry logic | | 433 | Quota Exceeded | Buy credits | | 500 | Server Error | Retry | | 503 | Service Unavailable | Temporary downtime |
🔧 Development
git clone https://github.com/aisearchapi/aisearchapi-mcp.git
cd aisearchapi-mcp
npm install
npm run build
npm run dev🛡️ Best Practices
- Clear context when switching topics
- Use markdown for richer UI
- Monitor credits
- Keep API key secure
📚 Resources
🎉 Start Now
npm install -g aisearchapi-mcp👉 Then configure Claude Desktop and start searching with AI Search API MCP Server.
🔍 SEO Keywords
AI Search API MCP server, semantic search MCP, context-aware MCP, Node.js AI Search API, MCP integration, AI Search API npm package
