Metis MCP Server

MCP (Model Context Protocol) server that exposes Metis code intelligence tools to Cursor/VS Code AI chat.

Installation

npm install -g @arbotdev/metis-mcp

Or use directly with npx (recommended for Cursor config):

npx @arbotdev/metis-mcp

Configuration

1. Get a JWT Token

Contact your Metis administrator to get a JWT token for your repositories.

2. Configure Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "metis": {
      "command": "npx",
      "args": ["-y", "@arbotdev/[email protected]"],
      "env": {
        "METIS_API_URL": "https://metis-api-13539721132.us-central1.run.app",
        "METIS_API_TOKEN": "your-jwt-token-here"
      }
    }
  }
}

3. Restart Cursor

Restart Cursor to load the MCP server.

Tools

| Tool | Description | |------|-------------| | metis_plan_change | Plan a code change with blast radius + AI explanation | | metis_explain_impact | Get blast radius / impact analysis for a symbol | | metis_search | Search for symbols in the codebase | | metis_resolve | Resolve symbol from file:line position | | metis_get_snippet | Get code snippet from a file | | metis_doctor | Check authentication and API connectivity |

Usage Examples

In Cursor chat, ask:

• "What will this change break?" → Uses metis_plan_change
• "What calls this function?" → Uses metis_explain_impact
• "Find the UserAuth class" → Uses metis_search
• "Check my Metis connection" → Uses metis_doctor

Plan a refactor

I want to refactor the get_backend function to support multiple database backends. 
What will this change break?

Check impact

Show me the blast radius for the CloudBackend class.

Find a symbol

Search for validate_token in the codebase.

Verify setup

Run metis doctor to check my connection.

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | METIS_API_TOKEN | Yes | - | JWT token for authentication | | METIS_API_URL | No | https://metis-api-... | Metis API base URL |

Troubleshooting

"Authentication Not Configured"

The METIS_API_TOKEN environment variable is not set. Add it to your Cursor MCP config.

"REPO_NOT_ALLOWED"

Your token doesn't have access to the requested repository. Check your repo_allowlist with metis_doctor.

"TOKEN_EXPIRED"

Your JWT has expired. Contact your Metis administrator for a new token.

License

MIT