ihyee-mcp
MCP (Model Context Protocol) server for the ihyee web intelligence API. Gives AI assistants like Claude, Cursor, and other MCP clients the ability to search the web, fetch pages, and render JavaScript-heavy sites.
Tools
| Tool | Description |
|---|---|
ihyee_search | Search the web and return extracted, summarized content from top results |
ihyee_fetch | Fetch and extract content from specific web page URLs |
ihyee_render | Force full browser rendering of a JavaScript-heavy web page |
Install
pip install ihyee-mcp
Configure
Set your ihyee API key as an environment variable:
export IHYEE_API_KEY="your_api_key_here"
Get an API key at ihyee.delta-telematics.ca.
Usage
With Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"ihyee": {
"command": "ihyee-mcp",
"env": {
"IHYEE_API_KEY": "your_api_key_here"
}
}
}
}
Config file locations:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
With Claude Code
claude mcp add ihyee -- ihyee-mcp
Then set the API key in your environment or pass it via the MCP config.
With Cursor
Add to your Cursor MCP settings (.cursor/mcp.json):
{
"mcpServers": {
"ihyee": {
"command": "ihyee-mcp",
"env": {
"IHYEE_API_KEY": "your_api_key_here"
}
}
}
}
Direct (stdio)
IHYEE_API_KEY=your_key ihyee-mcp
The server communicates over stdin/stdout using the MCP protocol.
Tool Details
ihyee_search
Search the web and return extracted content from top results.
Parameters:
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
query | string | Yes | Search query | |
max_results | integer | No | 5 | Number of results (1-10) |
content_mode | string | No | "both" | "both", "full_text", or "summary" |
render | boolean | No | false | Use browser rendering |
before | string | No | Results before date (YYYY-MM-DD) | |
after | string | No | Results after date (YYYY-MM-DD) | |
must_have | string | No | Required exact phrase |
ihyee_fetch
Fetch and extract content from specific URLs.
Parameters:
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
urls | string[] | Yes | URLs to fetch (max 10) | |
content_mode | string | No | "both" | "both", "full_text", or "summary" |
render | boolean | No | false | Use browser rendering |
ihyee_render
Force browser rendering for JavaScript-heavy pages.
Parameters:
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
url | string | Yes | URL to render | |
wait_for | string | No | "networkidle" | "networkidle", "domcontentloaded", or "load" |
wait_selector | string | No | CSS selector to wait for | |
timeout_ms | integer | No | 30000 | Max wait time in ms |
Development
git clone https://github.com/aizukanne/ihyee-mcp.git
cd ihyee-mcp
pip install -e ".[dev]"
pytest
License
MIT