@moncho-ai/analyst-discovery-mcp

Read-only MCP server for Moncho analyst discovery: sectors, landscapes, segments, organizations, products, pricing, needs, HS codes, taxonomy standards, and market facts. Also exposes an organization/product duplicate check before submitting a change request.

This is a thin authenticated client over the Moncho Discovery API. No database credentials, no Supabase access, and no raw SQL ever leave Moncho's servers.

Requirements

• Node.js >= 20
• A Moncho analyst API key (app.moncho.ai/analyst/dashboard → Workbench Access)

Quick start

No install needed. Point your MCP-compatible client at:

{
  "mcpServers": {
    "moncho-discovery": {
      "command": "npx",
      "args": ["-y", "@moncho-ai/analyst-discovery-mcp"],
      "env": {
        "MONCHO_API_URL": "https://app.moncho.ai",
        "MONCHO_AUTH_TOKEN": "your_api_key_here"
      }
    }
  }
}

This config shape works with Cursor (.cursor/mcp.json), Claude Desktop, Claude Code (claude mcp add), Windsurf, VS Code (MCP-enabled extensions), and any other MCP host that supports local stdio servers.

Environment variables

| Variable | Required | Default | |----------|----------|---------| | MONCHO_AUTH_TOKEN | Yes | — | | MONCHO_API_URL | No | https://app.moncho.ai |

Tools

| Tool | Purpose | |------|---------| | moncho_discovery_lookup | Read-only search: taxonomy, coverage, orgs, products, pricing, needs, hs-codes, taxonomy-standards, market-facts | | moncho_check_duplicate | Organization/product duplicate check before submitting new data |

Responses are wrapped in { data, meta }. Rate-limit and error responses return structured guidance text (retry timing, limit tier) instead of a raw tool crash.

Limits

| Window | Max requests | |--------|-------------:| | 1 minute | 60 (all discovery calls) | | 1 day | 500 (all discovery calls) | | 1 minute | 20 (market-facts only) |

Row caps: 20 default / 50 max per lookup; market-facts search capped at 25 rows.

What this package cannot do

• No raw SQL or arbitrary table access
• No write access — submissions go through the Moncho web app / change-request API
• No database or service-role credentials ever touch the client

Full documentation

See the Moncho Analyst Workbench repo, ANALYST_DISCOVERY_MCP.md, for the complete resource reference, troubleshooting, and REST/CLI fallback.

License

UNLICENSED — proprietary to Moncho.ai. Published for analyst and integration distribution; not open source.