grad-agent MCP Server
by i-ninteio.github.i-ninte/grad-agentv0.2.9
Autonomous MCP agent for grad school applications: prof discovery, cold emails, SOP, tracking.
context tax
queued
security
queued
cold start
queued
freshness
Active14d ago
Install grad-agent MCP server
Install in Claude Code
claude mcp add grad-agent -e ANTHROPIC_API_KEY='<anthropic-api-key>' -e SMTP_SERVER=smtp.gmail.com -e SMTP_PORT=587 -e SMTP_USERNAME='<smtp-username>' -e SMTP_PASSWORD='<smtp-password>' -e SMTP_FROM='<smtp-from>' -e GITHUB_TOKEN='<github-token>' -e HF_TOKEN='<hf-token>' -- uvx grad-agentInstall in Cursor
{
"mcpServers": {
"grad-agent": {
"command": "uvx",
"args": [
"grad-agent"
],
"env": {
"ANTHROPIC_API_KEY": "<anthropic-api-key>",
"SMTP_SERVER": "smtp.gmail.com",
"SMTP_PORT": "587",
"SMTP_USERNAME": "<smtp-username>",
"SMTP_PASSWORD": "<smtp-password>",
"SMTP_FROM": "<smtp-from>",
"GITHUB_TOKEN": "<github-token>",
"HF_TOKEN": "<hf-token>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"grad-agent": {
"command": "uvx",
"args": [
"grad-agent"
],
"env": {
"ANTHROPIC_API_KEY": "<anthropic-api-key>",
"SMTP_SERVER": "smtp.gmail.com",
"SMTP_PORT": "587",
"SMTP_USERNAME": "<smtp-username>",
"SMTP_PASSWORD": "<smtp-password>",
"SMTP_FROM": "<smtp-from>",
"GITHUB_TOKEN": "<github-token>",
"HF_TOKEN": "<hf-token>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"grad-agent": {
"type": "stdio",
"command": "uvx",
"args": [
"grad-agent"
],
"env": {
"ANTHROPIC_API_KEY": "<anthropic-api-key>",
"SMTP_SERVER": "smtp.gmail.com",
"SMTP_PORT": "587",
"SMTP_USERNAME": "<smtp-username>",
"SMTP_PASSWORD": "<smtp-password>",
"SMTP_FROM": "<smtp-from>",
"GITHUB_TOKEN": "<github-token>",
"HF_TOKEN": "<hf-token>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"grad-agent": {
"command": "uvx",
"args": [
"grad-agent"
],
"env": {
"ANTHROPIC_API_KEY": "<anthropic-api-key>",
"SMTP_SERVER": "smtp.gmail.com",
"SMTP_PORT": "587",
"SMTP_USERNAME": "<smtp-username>",
"SMTP_PASSWORD": "<smtp-password>",
"SMTP_FROM": "<smtp-from>",
"GITHUB_TOKEN": "<github-token>",
"HF_TOKEN": "<hf-token>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| ANTHROPIC_API_KEY | yes | yes | Anthropic API key used by Claude Haiku for hook synthesis and verification. |
| SMTP_SERVER | yes | — | SMTP host for the review mailer. |
| SMTP_PORT | yes | — | SMTP port. |
| SMTP_USERNAME | yes | — | SMTP username; used as From address by default. |
| SMTP_PASSWORD | yes | yes | SMTP password. Gmail App Password recommended. |
| SMTP_FROM | yes | — | Envelope From address for drafts emailed to the user's review inbox. |
| GITHUB_TOKEN | — | yes | Optional. Personal access token used to enumerate the user's public and private GitHub repos during catalog sync. |
| HF_TOKEN | — | yes | 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. |
Freshness
Active — last maintenance signal 14d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-09-25 · 14d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-09-25 · 14d ago · official registry · v0.2.9
FAQ
›How do I install the grad-agent MCP server in Claude Code?
Run: claude mcp add grad-agent -e ANTHROPIC_API_KEY='<anthropic-api-key>' -e SMTP_SERVER=smtp.gmail.com -e SMTP_PORT=587 -e SMTP_USERNAME='<smtp-username>' -e SMTP_PASSWORD='<smtp-password>' -e SMTP_FROM='<smtp-from>' -e GITHUB_TOKEN='<github-token>' -e HF_TOKEN='<hf-token>' -- uvx grad-agent. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does grad-agent require an API key?
Yes. It expects ANTHROPIC_API_KEY, SMTP_SERVER, SMTP_PORT, SMTP_USERNAME, SMTP_PASSWORD, SMTP_FROM, GITHUB_TOKEN, HF_TOKEN, of which 4 are secrets.
›Can I use grad-agent as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is grad-agent in the official MCP registry?
Yes, as io.github.i-ninte/grad-agent.