Skip to main content

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

Metadata

Release files for ihyee-mcp 1.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ihyee-mcp 1.2.0
File Size Uploaded
ihyee_mcp-1.2.0.tar.gz 9.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for ihyee-mcp 1.2.0
File Interpreter ABI Platform
ihyee_mcp-1.2.0-py3-none-any.whl Python 3 none any Details

Total release size: 18.1 kB

Release files / ihyee_mcp-1.2.0.tar.gz

Download URL ihyee_mcp-1.2.0.tar.gz
Size 9.3 kB
Tags Source
SHA-256 checksum
How to use checksums
f935eaa28db0e0c7960295b7f80c66256a92c19bf93d7065fb3a2760a692da7c
BLAKE2b-256 checksum
How to use checksums
cd62c510908374968738454243cb6cd2525bb92a48d08b6f605796f7beeff8e8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.13

Release files / ihyee_mcp-1.2.0-py3-none-any.whl

Download URL ihyee_mcp-1.2.0-py3-none-any.whl
Size 8.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b86636c5002a3e393f114fd26549838117ea8d3146cc2b1aaa4f3c9e5a43bdb6
BLAKE2b-256 checksum
How to use checksums
5060d8880ff3bc04354bf2c7d9ded836bcc3ae6c8c9ebe528182126fc04c330a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.13

Release history Release notifications | RSS feed

This release

1.2.0 This release

2 release files

1.1.0

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page