KEIRO MCP Server (Python)

Give your AI agents the power of real-time web intelligence

Installation • Configuration • Tools • Examples

---

What is this?

This is the official Model Context Protocol (MCP) server for the KEIRO API, written in Python. It enables AI assistants like Claude to search the web, conduct deep research, extract web content, and get AI-powered answers—all in real-time.

Installation

Using pip

pip install keiro-mcp

Using uv (recommended)

uv add keiro-mcp

From source

# Clone the repository
git clone https://github.com/keiro-labs/keiro-mcp-python.git
cd keiro-mcp-python

# Install with pip
pip install -e .

# Or with uv
uv pip install -e .

Configuration

1. Get your API Key

Sign up at keiro.dev and get your API key from the dashboard.

2. Configure Claude Desktop

Add to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "keiro": {
      "command": "keiro-mcp",
      "env": {
        "KEIRO_API_KEY": "your_api_key_here"
      }
    }
  }
}

Alternative using Python module:

{
  "mcpServers": {
    "keiro": {
      "command": "python",
      "args": ["-m", "keiro_mcp"],
      "env": {
        "KEIRO_API_KEY": "your_api_key_here"
      }
    }
  }
}

3. Restart Claude Desktop

The KEIRO tools will now be available in Claude.

---

Tools

Tool	Description
keiro_search	Fast web search with AI-optimized results
keiro_search_pro	Enhanced search with metadata and related queries
keiro_research	Deep research with summary and key points
keiro_research_pro	Comprehensive research with analysis and sources
keiro_answer	Direct AI-powered answers with citations
keiro_crawl	Extract content from any web page

---

Examples

Once configured, you can ask Claude things like:

"Search for the latest developments in quantum computing"

"Research the impact of AI on healthcare in 2024"

"What are the key features of the new iPhone?"

"Extract the main content from https://example.com/article"

Claude will use the appropriate KEIRO tool to fetch real-time information.

---

Environment Variables

Variable	Required	Description
KEIRO_API_KEY	Yes	Your KEIRO API key
KEIRO_BASE_URL	No	Custom API URL (default: production)

---

Development

# Clone and install in development mode
git clone https://github.com/keiro-labs/keiro-mcp-python.git
cd keiro-mcp-python
pip install -e ".[dev]"

# Run type checking
mypy src

# Run linting
ruff check src

# Run tests
pytest

---

API Reference

This MCP server uses the following KEIRO API endpoints:

• POST /search - Basic search
• POST /search-pro - Advanced search
• POST /research - Topic research
• POST /research-pro - Deep research
• POST /answer - AI answers
• POST /web-crawler - Page extraction

Full API documentation: keiro.dev/docs

---

License

MIT © KEIRO

---

_{Built with ❤️ by the KEIRO team}