jsonport-mcp

MCP (Model Context Protocol) server for the jsonport.com API.

Extracts structured product data from e-commerce URLs as MCP tools usable by any MCP-compatible client (Claude Desktop, Hermes Agent, etc.).

Tools

Install

pip install jsonport-mcp

Or from source:

git clone https://github.com/yourorg/jsonport-mcp.git
cd jsonport-mcp
pip install .

Usage

With Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "jsonport": {
      "command": "jsonport-mcp",
      "args": []
    }
  }
}

With Hermes Agent

Add to ~/.hermes/config.yaml:

mcp_servers:
  jsonport:
    command: "jsonport-mcp"

Run directly

# Start the MCP server on stdio
jsonport-mcp

# Or with a custom API endpoint
JSONPORT_API_URL=http://localhost:8181 jsonport-mcp

Test the server

# Send an initialize request via stdin
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"0.1"}}}' | jsonport-mcp

Environment Variables

Tool Details

extract_product

Extracts structured product data from an e-commerce URL.

• url (required): Product page URL (http:// or https://)
• geo (optional): Pricing region — us, eu, or auto (default: us)
• force (optional): Bypass cache (default: false)

Returns: JSON with title, price, currency, in_stock, rating, reviews_count, seller, brand, images, description, features, and more.

License

MIT