grad-agent
Rank #8,426io.github.i-ninte/grad-agent
Autonomous MCP agent for grad school applications: prof discovery, cold emails, SOP, tracking.
grad-agent is a Model Context Protocol (MCP) server published by i-ninte. It ranks #8,426 of 137,492 servers tracked on MCP Toplist, and its repository has 4 GitHub stars. grad-agent is listed across 3 registries — Official MCP, PulseMCP and Glama, with 7 tracked versions. It was first listed on Jul 5, 2026 and most recently updated on Sep 25, 2026.
Ranks ahead of 129,066 of 137,492 servers on MCP Toplist.
Use grad-agent
Requires user-supplied configuration before first use — typically an API key, token or connection string set via environment variables.
claude mcp add grad-agent -e "ANTHROPIC_API_KEY=<your ANTHROPIC_API_KEY>" -e "SMTP_SERVER=<your SMTP_SERVER>" -e "SMTP_PORT=<your SMTP_PORT>" -e "SMTP_USERNAME=<your SMTP_USERNAME>" -e "SMTP_PASSWORD=<your SMTP_PASSWORD>" -e "SMTP_FROM=<your SMTP_FROM>" -e "GITHUB_TOKEN=<your GITHUB_TOKEN>" -e "HF_TOKEN=<your HF_TOKEN>" -e "GRAD_AGENT_HOME=<your GRAD_AGENT_HOME>" -e "LOR_LETTERHEAD_PATH=<your LOR_LETTERHEAD_PATH>" -e "LOR_LETTERHEAD_WIDTH=<your LOR_LETTERHEAD_WIDTH>" -- uvx server grad-agentReplace each placeholder with your own value before saving.
[mcp_servers.grad-agent]
command = "uvx"
args = ["server", "grad-agent"]
[mcp_servers.grad-agent.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>"Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"grad-agent": {
"command": "uvx",
"args": [
"server",
"grad-agent"
],
"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>"
}
}
}
}Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.
{
"mcpServers": {
"grad-agent": {
"command": "uvx",
"args": [
"server",
"grad-agent"
],
"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>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.
{
"servers": {
"grad-agent": {
"type": "stdio",
"command": "uvx",
"args": [
"server",
"grad-agent"
],
"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>"
}
}
}
}Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"grad-agent": {
"command": "uvx",
"args": [
"server",
"grad-agent"
],
"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>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"grad-agent": {
"command": "uvx",
"args": [
"server",
"grad-agent"
],
"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>"
}
}
}
}Replace each placeholder with your own value before saving.
Show your rank
Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.
[](https://mcptoplist.com/server/io.github.i-ninte%2Fgrad-agent)<a href="https://mcptoplist.com/server/io.github.i-ninte%2Fgrad-agent"><img src="https://mcptoplist.com/badge/io.github.i-ninte%2Fgrad-agent.svg" alt="MCP Toplist: Top 10% of 137,492" /></a>Variants: append ?metric=score or ?metric=stars to the image URL.
Listed on 3 registries
i-ninte
Available versions (7)
| Version | Published |
|---|---|
| 0.2.9 | Sep 25, 2026 |
| 0.2.5 | Jul 14, 2026 |
| 0.2.4 | Jul 13, 2026 |
| 0.2.3 | Jul 13, 2026 |
| 0.2.1 | Jul 12, 2026 |
| 0.1.3 | Jul 12, 2026 |
| 0.1.2 | Jul 6, 2026 |
Frequently asked questions
- Who maintains grad-agent?
- grad-agent is maintained by i-ninte, which publishes 1 MCP server (7 total versions) tracked on MCP Toplist.
- Is grad-agent listed on the Official MCP Registry?
- Yes — grad-agent is listed on the Official MCP Registry, alongside PulseMCP and Glama.
- How many versions does grad-agent have?
- MCP Toplist tracks 7 versions of grad-agent, most recently published on Sep 25, 2026.
- Where can I find the source code for grad-agent?
- The source code for grad-agent is hosted at github.com/i-ninte/grad-agent.
Do you run this server?
Community projects list the MCP servers behind real agents and apps. Publish yours and this page will link to it.