grad-agent MCP Server

Name: grad-agent MCP Server
Author: io.github.i-ninte

io.github.i-ninte/grad-agent

Repository Registry

What is the grad-agent MCP server?

Autonomous MCP agent for grad school applications: prof discovery, cold emails, SOP, tracking.

How to install grad-agent

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

ANTHROPIC_API_KEY
required
secret
Anthropic API key used by Claude Haiku for hook synthesis and verification.
SMTP_SERVER
required
SMTP host for the review mailer.
SMTP_PORT
required
SMTP port.
SMTP_USERNAME
required
SMTP username; used as From address by default.
SMTP_PASSWORD
required
secret
SMTP password. Gmail App Password recommended.
SMTP_FROM
required
Envelope From address for drafts emailed to the user's review inbox.
GITHUB_TOKEN
secret
Optional. Personal access token used to enumerate the user's public and private GitHub repos during catalog sync.
HF_TOKEN
secret
Optional. HuggingFace token used to enumerate the user's published models and datasets during catalog sync.
GRAD_AGENT_HOME
Optional. Override the default ~/.grad-agent/ location for profile, programs, secrets, and data.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "grad-agent": {
      "command": "uvx",
      "args": [
        "grad-agent",
        "server"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
        "SMTP_SERVER": "<YOUR_SMTP_SERVER>",
        "SMTP_PORT": "<YOUR_SMTP_PORT>",
        "SMTP_USERNAME": "<YOUR_SMTP_USERNAME>",
        "SMTP_PASSWORD": "<YOUR_SMTP_PASSWORD>",
        "SMTP_FROM": "<YOUR_SMTP_FROM>",
        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>",
        "HF_TOKEN": "<YOUR_HF_TOKEN>",
        "GRAD_AGENT_HOME": "<YOUR_GRAD_AGENT_HOME>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "grad-agent": {
      "command": "uvx",
      "args": [
        "grad-agent",
        "server"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
        "SMTP_SERVER": "<YOUR_SMTP_SERVER>",
        "SMTP_PORT": "<YOUR_SMTP_PORT>",
        "SMTP_USERNAME": "<YOUR_SMTP_USERNAME>",
        "SMTP_PASSWORD": "<YOUR_SMTP_PASSWORD>",
        "SMTP_FROM": "<YOUR_SMTP_FROM>",
        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>",
        "HF_TOKEN": "<YOUR_HF_TOKEN>",
        "GRAD_AGENT_HOME": "<YOUR_GRAD_AGENT_HOME>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "grad-agent": {
      "command": "uvx",
      "args": [
        "grad-agent",
        "server"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
        "SMTP_SERVER": "<YOUR_SMTP_SERVER>",
        "SMTP_PORT": "<YOUR_SMTP_PORT>",
        "SMTP_USERNAME": "<YOUR_SMTP_USERNAME>",
        "SMTP_PASSWORD": "<YOUR_SMTP_PASSWORD>",
        "SMTP_FROM": "<YOUR_SMTP_FROM>",
        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>",
        "HF_TOKEN": "<YOUR_HF_TOKEN>",
        "GRAD_AGENT_HOME": "<YOUR_GRAD_AGENT_HOME>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "grad-agent": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "grad-agent",
        "server"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
        "SMTP_SERVER": "<YOUR_SMTP_SERVER>",
        "SMTP_PORT": "<YOUR_SMTP_PORT>",
        "SMTP_USERNAME": "<YOUR_SMTP_USERNAME>",
        "SMTP_PASSWORD": "<YOUR_SMTP_PASSWORD>",
        "SMTP_FROM": "<YOUR_SMTP_FROM>",
        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>",
        "HF_TOKEN": "<YOUR_HF_TOKEN>",
        "GRAD_AGENT_HOME": "<YOUR_GRAD_AGENT_HOME>"
      }
    }
  }
}

Claude Code

claude mcp add grad-agent --env ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY> --env SMTP_SERVER=<YOUR_SMTP_SERVER> --env SMTP_PORT=<YOUR_SMTP_PORT> --env SMTP_USERNAME=<YOUR_SMTP_USERNAME> --env SMTP_PASSWORD=<YOUR_SMTP_PASSWORD> --env SMTP_FROM=<YOUR_SMTP_FROM> --env GITHUB_TOKEN=<YOUR_GITHUB_TOKEN> --env HF_TOKEN=<YOUR_HF_TOKEN> --env GRAD_AGENT_HOME=<YOUR_GRAD_AGENT_HOME> -- uvx grad-agent server