grad-agent
Autonomous MCP agent for grad school applications: prof discovery, cold emails, SOP…
- Pricing
- Open source
- Runs
- Locally
- Version
- 0.2.9
- Listing updated
- 5 days ago
About grad-agent
grad-agent is an open-source MCP server. It runs locally on your machine and is started by your AI client.
Autonomous MCP agent for grad school applications: prof discovery, cold emails, SOP, tracking.
Install
Run in a terminal
claude mcp add grad-agent --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' --env SMTP_SERVER='<SMTP_SERVER>' --env SMTP_PORT='<SMTP_PORT>' --env SMTP_USERNAME='<SMTP_USERNAME>' --env SMTP_PASSWORD='<SMTP_PASSWORD>' --env SMTP_FROM='<SMTP_FROM>' --env GITHUB_TOKEN='<GITHUB_TOKEN>' --env HF_TOKEN='<HF_TOKEN>' -- uvx grad-agentAdd to claude_desktop_config.json
{
"mcpServers": {
"grad-agent": {
"command": "uvx",
"args": [
"grad-agent"
],
"env": {
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
"SMTP_SERVER": "<SMTP_SERVER>",
"SMTP_PORT": "<SMTP_PORT>",
"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
{
"mcpServers": {
"grad-agent": {
"command": "uvx",
"args": [
"grad-agent"
],
"env": {
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
"SMTP_SERVER": "<SMTP_SERVER>",
"SMTP_PORT": "<SMTP_PORT>",
"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
{
"servers": {
"grad-agent": {
"type": "stdio",
"command": "uvx",
"args": [
"grad-agent"
],
"env": {
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
"SMTP_SERVER": "<SMTP_SERVER>",
"SMTP_PORT": "<SMTP_PORT>",
"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
{
"mcpServers": {
"grad-agent": {
"command": "uvx",
"args": [
"grad-agent"
],
"env": {
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
"SMTP_SERVER": "<SMTP_SERVER>",
"SMTP_PORT": "<SMTP_PORT>",
"SMTP_USERNAME": "<SMTP_USERNAME>",
"SMTP_PASSWORD": "<SMTP_PASSWORD>",
"SMTP_FROM": "<SMTP_FROM>",
"GITHUB_TOKEN": "<GITHUB_TOKEN>",
"HF_TOKEN": "<HF_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"grad-agent": {
"command": "uvx",
"args": [
"grad-agent"
],
"env": {
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
"SMTP_SERVER": "<SMTP_SERVER>",
"SMTP_PORT": "<SMTP_PORT>",
"SMTP_USERNAME": "<SMTP_USERNAME>",
"SMTP_PASSWORD": "<SMTP_PASSWORD>",
"SMTP_FROM": "<SMTP_FROM>",
"GITHUB_TOKEN": "<GITHUB_TOKEN>",
"HF_TOKEN": "<HF_TOKEN>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
ANTHROPIC_API_KEYAnthropic API key used by Claude Haiku for hook synthesis and verification.RequiredSMTP_SERVERSMTP host for the review mailer.RequiredSMTP_PORTSMTP port.RequiredSMTP_USERNAMESMTP username; used as From address by default.RequiredSMTP_PASSWORDSMTP password. Gmail App Password recommended.RequiredSMTP_FROMEnvelope From address for drafts emailed to the user's review inbox.RequiredGITHUB_TOKENOptional. Personal access token used to enumerate the user's public and private GitHub repos during catalog sync.HF_TOKENOptional. HuggingFace token used to enumerate the user's published models and datasets during catalog sync.GRAD_AGENT_HOMEOptional. Override the default ~/.grad-agent/ location for profile, programs, secrets, and data.LOR_LETTERHEAD_PATHOptional. 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_WIDTHOptional. LaTeX length for the letterhead image width (e.g. '2.5in'). Used only when LOR_LETTERHEAD_PATH is set.
Pricing
Open source
grad-agent FAQ
Is grad-agent free?
Yes. grad-agent is open source, so you can use and self-host it for free.
How do I add grad-agent to Claude Code?
Run this command in your terminal: claude mcp add grad-agent --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' --env SMTP_SERVER='<SMTP_SERVER>' --env SMTP_PORT='<SMTP_PORT>' --env SMTP_USERNAME='<SMTP_USERNAME>' --env SMTP_PASSWORD='<SMTP_PASSWORD>' --env SMTP_FROM='<SMTP_FROM>' --env GITHUB_TOKEN='<GITHUB_TOKEN>' --env HF_TOKEN='<HF_TOKEN>' -- uvx grad-agent
Where this comes from
- Description: from the official MCP Registry entry.
- Install steps: from the official MCP Registry entry.