grad-agent

Official

by i-ninte · Python

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

Topics

graduate-schoolmcp

Install

Configuration

Environment variables

ANTHROPIC_API_KEYrequiredsecret

Anthropic API key used by Claude Haiku for hook synthesis and verification.

SMTP_SERVERrequireddefault smtp.gmail.com

SMTP host for the review mailer.

SMTP_PORTrequireddefault 587

SMTP port.

SMTP_USERNAMErequired

SMTP username; used as From address by default.

SMTP_PASSWORDrequiredsecret

SMTP password. Gmail App Password recommended.

SMTP_FROMrequired

Envelope From address for drafts emailed to the user's review inbox.

GITHUB_TOKENsecret

Optional. Personal access token used to enumerate the user's public and private GitHub repos during catalog sync.

HF_TOKENsecret

Optional. HuggingFace token used to enumerate the user's published models and datasets during catalog sync.

GRAD_AGENT_HOMEdefault ~/.grad-agent

Optional. Override the default ~/.grad-agent/ location for profile, programs, secrets, and data.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "grad-agent": {
      "command": "uvx",
      "args": [
        "grad-agent"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
        "SMTP_SERVER": "smtp.gmail.com",
        "SMTP_PORT": "587",
        "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": "~/.grad-agent"
      }
    }
  }
}