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.