Skip to main content
This is a Model Context Protocol (MCP) server that integrates the AI Search API into MCP-compatible apps.
It brings semantic search, context awareness, and source citations directly into your workflows. 👉 Get started now:

​
Features

  • 🔍 Intelligent Semantic Search – Natural language queries 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

npm install -g aisearchapi-mcp

​
From source

git clone https://github.com/aisearchapi/aisearchapi-mcp.git
cd aisearchapi-mcp
npm install
npm run build

​
Configuration

​
1. Get API Key

Create an account and copy your key:

​
2. Environment Variables

Set up .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

First, install Claude Code: 
npm install -g @anthropic-ai/claude-code
Go through the authorization process to access Claude Code.
Then set up your local MCP: 
claude mcp add aisearchapi "npx -y aisearchapi-mcp" --env API_KEY=<YOUR-API-KEY>
Check if it’s added correctly: 
claude mcp list
You should see: 
Checking MCP server health...
aisearchapi: npx -y aisearchapi-mcp  - ✓ Connected
Now you’re ready to go!

​
Command Line Usage

List available tools: 
node dist/index.js --list-tools
Check balance: 
node dist/index.js --check-balance
Run the server: 
node dist/index.js

​
Error Codes

CodeMeaningFix
401UnauthorizedInvalid key → Get a new key
429Too Many RequestsSlow down or add retry logic
433Quota ExceededBuy credits / upgrade
500Server ErrorTry again later
503Service DownTemporary 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 output for richer UI
  • Monitor credits regularly
  • Secure your API key with environment variables

​
Resources

​
Start Now

Install the package, configure Claude Desktop, and start searching with the AI Search API MCP Server: 
npm install -g aisearchapi-mcp