Phenomainonresearch← Back to phenomainon.com
MCP server

Connect any MCP client

The phenomainon MCP server speaks the official Streamable HTTP transport at https://mcp.phenomainon.com/mcp. Authenticate with an X-API-Key header. The free tier gives you one tool call before sign-in.

Claude Code (CLI)

claude mcp add --transport http phenomainon \
  https://mcp.phenomainon.com/mcp \
  --header "X-API-Key: YOUR_KEY"

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json(macOS) or the equivalent on Windows/Linux.

{
  "mcpServers": {
    "phenomainon": {
      "transport": {
        "type": "streamable-http",
        "url": "https://mcp.phenomainon.com/mcp",
        "headers": { "X-API-Key": "YOUR_KEY" }
      }
    }
  }
}

Cursor

Add to your Cursor settings under MCP servers.

{
  "mcp": {
    "servers": {
      "phenomainon": {
        "url": "https://mcp.phenomainon.com/mcp",
        "headers": { "X-API-Key": "YOUR_KEY" }
      }
    }
  }
}

Tools

  • search_cases(state?, country?, shape?, theme?, year_from?, year_to?, min_sources?, limit?)

    Structured filter search. Returns events matching ALL filters, sorted by source_count and date.

    {
      "name": "search_cases",
      "arguments": {
        "country": "US",
        "state": "NY",
        "shape": "triangle",
        "year_from": 1982,
        "year_to": 1986,
        "min_sources": 2,
        "limit": 25
      }
    }
  • semantic_search(query, k?, state?, shape?, min_sources?)

    Embedding-space free-text search. Optional structured filters narrow the candidate set before ranking.

    {
      "name": "semantic_search",
      "arguments": {
        "query": "triangular silent low altitude over a freeway",
        "k": 20
      }
    }
  • get_case(pcf)

    Full detail for one case: every field, sources, scoring. Use this after search to drill down.

    {
      "name": "get_case",
      "arguments": { "pcf": "PCF-103868" }
    }
  • related(pcf)

    The most similar cases to a flagship case via the embedding index.

    {
      "name": "related",
      "arguments": { "pcf": "PCF-103868" }
    }
  • stats(group_by, state?, shape?, theme?)

    Aggregate counts for charts. group_by: year | decade | state | country | shape | theme | source_count.

    {
      "name": "stats",
      "arguments": { "group_by": "decade" }
    }
  • list_themes()

    All cataloged themes with counts and descriptions. Use the keys with the `theme` filter on other tools.

    { "name": "list_themes", "arguments": {} }
  • dataset_overview()

    Quick health check: totals, date range, multi-source corroboration count.

    { "name": "dataset_overview", "arguments": {} }

Getting a key

Anonymous access is rate-limited to one tool call. For researcher access (vetted, free) email joe.schurman@gmail.com with a one-line note about what you're using it for, or sign in via the (forthcoming) account flow.