/mcp/installation

Install

Wire Mireye Earth into Claude Desktop, Claude Code, Cursor, or a custom MCP agent.

​ Claude Code — hosted OAuth

claude mcp remove mireye-earth -s user
  • /mcp__mireye-earth__mireye_ask <lat> <lng> <question>
  • /mcp__mireye-earth__mireye_fetch <lat> <lng> [fields] [preset]

​ Local stdio adapter — fallback

uvx mireye-mcp

​ Claude Desktop

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
JSON
{
  "mcpServers": {
    "mireye-earth": {
      "command": "uvx",
      "args": ["mireye-mcp"]
    }
  }
}

​ uvx not on PATH?

JSON
{
  "mcpServers": {
    "mireye-earth": {
      "command": "/Users/you/.local/bin/uvx",
      "args": ["mireye-mcp"]
    }
  }
}

​ Cursor

  • ~/.cursor/mcp.json (global)
  • <repo>/.cursor/mcp.json (workspace)
JSON
{
  "mcpServers": {
    "mireye-earth": {
      "command": "uvx",
      "args": ["mireye-mcp"]
    }
  }
}

​ Custom MCP agent (Python SDK)

Python
import asyncio
from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client

PARAMS = StdioServerParameters(
    command="uvx",
    args=["mireye-mcp"],
    # Optional: env vars passed to the spawned process.
    env={"MIREYE_BASE_URL": "https://api.mireye.com"},
)

async def main():
    async with stdio_client(PARAMS) as (read, write):
        async with ClientSession(read, write) as session:
            await session.initialize()

            tools = await session.list_tools()
            print([t.name for t in tools.tools])
            # ['mireye_ask', 'mireye_fetch']
            resources = await session.list_resources()
            prompts = await session.list_prompts()

            result = await session.call_tool(
                "mireye_ask",
                {
                    "lat": 40.7128,
                    "lng": -74.0060,
                    "question": "What is the elevation here?",
                },
            )
            print(result.content)

asyncio.run(main())

​ Configuration

JSON
{
  "mcpServers": {
    "mireye-earth": {
      "command": "uvx",
      "args": ["mireye-mcp"],
      "env": {
        "MIREYE_BASE_URL": "https://staging.mireye.example"
      }
    }
  }
}

​ Verify with MCP Inspector

Shell
npx @modelcontextprotocol/inspector uvx mireye-mcp
  • Tools list shows exactly two entries: mireye_ask, mireye_fetch.
  • Resources list shows mireye://catalog/fields, mireye://catalog/presets, and mireye://catalog/us-envelope.
  • Prompt list includes mireye_site_report, mireye_flood_check, mireye_wildfire_underwrite, and mireye_pick_fields.
  • Call mireye_ask with lat: 40.7128, lng: -74.006, question: "elevation?" — get a JSON response with answer, confidence, citations.
  • Call mireye_fetch with lat: 40.7128, lng: -74.006, fields: ["elevation"] — get a JSON response with fields.elevation.value populated.

​ Authentication

mireye-mcp login

​ Updating

Shell
pip install --upgrade mireye-mcp