grad-agent MCP Server

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.
LOR_LETTERHEAD_PATH
Optional. Absolute path to a letterhead / company logo image (.png / .jpg / .pdf) embedded at the top of Letters of Recommendation during LaTeX compile. Leave unset for a plain top block. Can also be set at runtime via the `set_letterhead` MCP tool.
LOR_LETTERHEAD_WIDTH
Optional. LaTeX length for the letterhead image width (e.g. '2.5in'). Used only when LOR_LETTERHEAD_PATH is set.

~/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>",
        "LOR_LETTERHEAD_PATH": "<YOUR_LOR_LETTERHEAD_PATH>",
        "LOR_LETTERHEAD_WIDTH": "<YOUR_LOR_LETTERHEAD_WIDTH>"
      }
    }
  }
}

Related MCP servers

Assurance

Checks what an agent did NOT read. Coverage over a retrieval step or a folder.

View repository →

Automan

Autonomous AI agent selling pay-per-call skills settled with x402 micropayments (USDC).

View repository →

io.github.iFan6oy/flash-props-api

Maintained

Flash Props API: player-prop analysis, projections, evidence, and line movement over REST/MCP.

MIT

View repository →

Sorqen

Active

Sportsbook-derived no-vig fair value with confidence, provenance, and history over REST/MCP.

MIT

View repository →

io.github.iPAYX-Technologies/mcp-fx-audit

Maintained

FX forensic audit MCP. Detects hidden bank markups on cross-border payments. FINTRAC MSB.

Python

View repository →

io.github.iQuesta/MCP-iQuesta

Maintained

Recherche d'offres de stage et d'alternance en France via le réseau iQuesta.com

MIT

View repository →