Package Exports

aisearchapi-mcp
aisearchapi-mcp/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (aisearchapi-mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

🤖 AI Search API MCP Server

A Model Context Protocol (MCP) server that integrates the AI Search API into Claude Desktop and other 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-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 your account and copy your key:

Join | Login | Dashboard

2. Environment Variables

.env file:

AISEARCHAPI_KEY=your-api-key-here
AISEARCHAPI_BASE_URL=https://api.aisearchapi.io
AISEARCHAPI_TIMEOUT=30000
AISEARCHAPI_VERBOSE=false

3. Configure Claude Desktop

Edit claude_desktop_config.json and add:

{
  "mcpServers": {
    "aisearchapi": {
      "command": "npx",
      "args": ["-y", "aisearchapi-mcp"],
      "env": {
        "AISEARCHAPI_KEY": "your-api-key-here"
      }
    }
  }
}

🛠️ Available Tools

`aisearch-search`

Perform contextual semantic searches.

Use aisearch-search to find renewable energy benefits

`aisearch-balance`

Check credits and balance.

Check my AI Search API balance

`aisearch-clear-context`

Clear stored conversation history.

Clear the search context

💻 Command Line Usage

List tools:

node dist/index.js --list-tools

Check balance:

node dist/index.js --check-balance

Run server:

node dist/index.js

📚 Examples in Claude

Basic search:
Search for latest developments in quantum computing using aisearch
Contextual search:
Use aisearch to find info about solar panels for homes
Balance check:
What's my AI Search API balance?

⚠️ Error Codes

Code	Meaning	Fix
401	Unauthorized	Invalid key → Get key
429	Too Many Requests	Slow down or add retry logic
433	Quota Exceeded	Buy credits / upgrade
500	Server Error	Try again later
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

Test locally:

echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | node dist/index.js

🛡️ Best Practices

Clear context when switching topics
Use markdown output for richer UI
Monitor credits regularly
Secure your API key with env vars

📚 Resources

🎉 Start Now

npm install -g aisearchapi-mcp

Then configure Claude Desktop and start searching with AI Search API MCP Server.
👉 Sign up today and unlock semantic search in Claude Desktop.

🔍 SEO Keywords

AI Search API MCP server, Claude Desktop semantic search, context-aware AI MCP, AI Search API Node.js MCP, AI Search API key, MCP integration with Claude