@rotifer/mcp-server

MCP (Model Context Protocol) server for the Rotifer Protocol Gene ecosystem. Lets AI agents search, inspect, compare, and rank Genes directly from any MCP-compatible IDE.

Quick Start

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "rotifer": {
      "command": "npx",
      "args": ["-y", "@rotifer/mcp-server"]
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "rotifer": {
      "command": "npx",
      "args": ["-y", "@rotifer/mcp-server"]
    }
  }
}

Windsurf / Other MCP Clients

Use the same npx command — any client that supports MCP stdio transport will work.

Tools

Tool	Description
`search_genes`	Search the Gene ecosystem by name, domain, or description
`get_gene_detail`	Get detailed info about a specific Gene (phenotype, fitness, metadata)
`get_arena_rankings`	Get Arena rankings for a domain, sorted by F(g) fitness score
`compare_genes`	Side-by-side fitness comparison of 2–5 Genes
`get_gene_stats`	Download statistics for a Gene (total, 7d, 30d, 90d)
`get_leaderboard`	Developer reputation leaderboard
`get_developer_profile`	Developer public profile and reputation data
`list_local_genes`	Scan local workspace for installed Genes

Resources

MCP Resources let AI clients reference Rotifer data as context:

URI Template	Description
`rotifer://genes/{gene_id}/stats`	Gene download statistics
`rotifer://genes/{gene_id}`	Gene detail + phenotype
`rotifer://developers/{username}`	Developer profile + reputation
`rotifer://leaderboard`	Top developers by reputation score
`rotifer://local/genes`	Local Gene inventory

Examples

Search for web search genes:

"Search for genes in the search.web domain"

Find the best gene for a task:

"Show me Arena rankings for code.format"

Compare two genes:

"Compare these two genes: [id-1] vs [id-2]"

Check download trends:

"Show me download stats for this gene"

Explore local workspace:

"What genes are installed locally?"

Configuration

Zero-config by default — connects to the public Rotifer Cloud API.

To use a custom endpoint, create ~/.rotifer/cloud.json:

{
  "endpoint": "https://your-supabase-instance.supabase.co",
  "anonKey": "your-anon-key"
}

Or set environment variables:

ROTIFER_CLOUD_ENDPOINT=https://your-instance.supabase.co
ROTIFER_CLOUD_ANON_KEY=your-anon-key

Requirements

Node.js >= 20

License

Apache-2.0

@rotifer/mcp-server