KEIRO MCP Server

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.

Related MCP server: KEIRO MCP Server

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

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

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