grad-agent

Name: grad-agent
Author: i-ninte

i-ninte

Graduate Agent is an open-source AI assistant that helps students discover research opportunities, personalize application materials, and manage the entire graduate admissions pipeline from search to submission

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

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

~/.codex/config.toml

[mcp_servers.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>" }

# codex 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

~/.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>"
      }
    }
  }
}

.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>"
      }
    }
  }
}

~/.gemini/settings.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>"
      }
    }
  }
}

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>"
      }
    }
  }
}

.trae/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>"
      }
    }
  }
}

Environment variables

ANTHROPIC_API_KEY
SMTP_SERVER
SMTP_PORT
SMTP_USERNAME
SMTP_PASSWORD
SMTP_FROM
GITHUB_TOKEN
HF_TOKEN

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related