Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

{
  "mcpServers": {
    "grad-agent": {
      "command": "uvx",
      "args": [
        "server",
        "grad-agent==0.2.9"
      ],
      "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}",
        "GRAD_AGENT_HOME": "~/.grad-agent",
        "LOR_LETTERHEAD_WIDTH": "2.2in"
      }
    }
  }
}

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}" -e "GRAD_AGENT_HOME=~/.grad-agent" -e "LOR_LETTERHEAD_WIDTH=2.2in" -- uvx server grad-agent==0.2.9

[mcp_servers.grad-agent]
command = "uvx"
args = ["server", "grad-agent==0.2.9"]
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}", "GRAD_AGENT_HOME" = "~/.grad-agent", "LOR_LETTERHEAD_WIDTH" = "2.2in" }

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "grad-agent": {
      "type": "local",
      "command": [
        "uvx",
        "server",
        "grad-agent==0.2.9"
      ],
      "enabled": true,
      "environment": {
        "ANTHROPIC_API_KEY": "{env:ANTHROPIC_API_KEY}",
        "SMTP_SERVER": "smtp.gmail.com",
        "SMTP_PORT": "587",
        "SMTP_USERNAME": "{env:SMTP_USERNAME}",
        "SMTP_PASSWORD": "{env:SMTP_PASSWORD}",
        "SMTP_FROM": "{env:SMTP_FROM}",
        "GITHUB_TOKEN": "{env:GITHUB_TOKEN}",
        "HF_TOKEN": "{env:HF_TOKEN}",
        "GRAD_AGENT_HOME": "~/.grad-agent",
        "LOR_LETTERHEAD_WIDTH": "2.2in"
      }
    }
  }
}

{
  "mcpServers": {
    "grad-agent": {
      "command": "uvx",
      "args": [
        "server",
        "grad-agent==0.2.9"
      ],
      "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}",
        "GRAD_AGENT_HOME": "~/.grad-agent",
        "LOR_LETTERHEAD_WIDTH": "2.2in"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=grad-agent&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyJzZXJ2ZXIiLCJncmFkLWFnZW50PT0wLjIuOSJdLCJlbnYiOnsiQU5USFJPUElDX0FQSV9LRVkiOiIke0FOVEhST1BJQ19BUElfS0VZfSIsIlNNVFBfU0VSVkVSIjoic210cC5nbWFpbC5jb20iLCJTTVRQX1BPUlQiOiI1ODciLCJTTVRQX1VTRVJOQU1FIjoiJHtTTVRQX1VTRVJOQU1FfSIsIlNNVFBfUEFTU1dPUkQiOiIke1NNVFBfUEFTU1dPUkR9IiwiU01UUF9GUk9NIjoiJHtTTVRQX0ZST019IiwiR0lUSFVCX1RPS0VOIjoiJHtHSVRIVUJfVE9LRU59IiwiSEZfVE9LRU4iOiIke0hGX1RPS0VOfSIsIkdSQURfQUdFTlRfSE9NRSI6In4vLmdyYWQtYWdlbnQiLCJMT1JfTEVUVEVSSEVBRF9XSURUSCI6IjIuMmluIn19"
}

{
  "servers": {
    "grad-agent": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "server",
        "grad-agent==0.2.9"
      ],
      "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}",
        "GRAD_AGENT_HOME": "~/.grad-agent",
        "LOR_LETTERHEAD_WIDTH": "2.2in"
      }
    }
  }
}

{
  "mcpServers": {
    "grad-agent": {
      "command": "uvx",
      "args": [
        "server",
        "grad-agent==0.2.9"
      ],
      "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}",
        "GRAD_AGENT_HOME": "~/.grad-agent",
        "LOR_LETTERHEAD_WIDTH": "2.2in"
      }
    }
  }
}

extensions:
  "grad-agent":
    enabled: true
    name: "grad-agent"
    type: stdio
    cmd: "uvx"
    args:
      - "server"
      - "grad-agent==0.2.9"
    envs:
      "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}"
      "GRAD_AGENT_HOME": "~/.grad-agent"
      "LOR_LETTERHEAD_WIDTH": "2.2in"
    timeout: 300

Placeholders to fill from your own secret store: ${ANTHROPIC_API_KEY}, ${SMTP_PASSWORD}, ${GITHUB_TOKEN}, ${HF_TOKEN}. The registry never accepts secret values.

This is a local package: the command runs on your machine.

Quality – / 100not scored

Not scored: fewer than three checks apply, usually because no remote answered a credential-free probe or the server is a local package.

protocoln/a · weight 25

n/a
protocol.modern, protocol.stateless, protocol.transport, protocol.list_ttlno remote answered a protocol handshake (not probed yet, unreachable, or local-only)

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygienen/a · weight 30

n/a
tools.descriptions, tools.description_length, tools.schemas, tools.annotations, tools.directory_hints, tools.token_cost, tools.api_dumptool list unknown (behind auth, not probed, or empty)

stabilityn/a · weight 15

n/a
stability.changes, stability.rug_pulltool list unknown

dependencies100 · weight 15

pass
deps.known_vulnsno known advisory in 88 resolved packages
pass
deps.mcp_sdk_versionmcp 2.2.0, no known advisory
pass
deps.resolvable[email protected] resolved: 88 packages

Tool list unknown · checked 2026-10-20 11:08 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 91 / 100

provenance80

livenessn/a

freshness100

hygiene100

+repository +namespace-matches-repo ~liveness-unmeasured +updated-25d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Dependencies

[email protected] PyPI87 dependencies, resolved · MCP SDK mcp 2.2.0 · advisories checked 2026-10-19

No known advisory affects this dependency graph.

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.

Endpoints

package	registry	version	runtime	secrets
`grad-agent`	pypi	0.2.9	uvx	`ANTHROPIC_API_KEY`, `SMTP_PASSWORD`, `GITHUB_TOKEN`, `HF_TOKEN`

Tools (0)

No tools observed. Local packages are never executed by the registry.

Schemas: list_tools.

Similar MCP servers

Official server.json

{
  "name": "io.github.i-ninte/grad-agent",
  "title": "grad-agent",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "version": "0.2.9",
  "packages": [
    {
      "version": "0.2.9",
      "transport": {
        "type": "stdio"
      },
      "identifier": "grad-agent",
      "runtimeHint": "uvx",
      "registryType": "pypi",
      "registryBaseUrl": "https://pypi.org",
      "runtimeArguments": [
        {
          "type": "positional",
          "value": "server",
          "isRequired": true
        }
      ],
      "environmentVariables": [
        {
          "name": "ANTHROPIC_API_KEY",
          "isSecret": true,
          "isRequired": true,
          "description": "Anthropic API key used by Claude Haiku for hook synthesis and verification."
        },
        {
          "name": "SMTP_SERVER",
          "default": "smtp.gmail.com",
          "isRequired": true,
          "description": "SMTP host for the review mailer."
        },
        {
          "name": "SMTP_PORT",
          "default": "587",
          "isRequired": true,
          "description": "SMTP port."
        },
        {
          "name": "SMTP_USERNAME",
          "isRequired": true,
          "description": "SMTP username; used as From address by default."
        },
        {
          "name": "SMTP_PASSWORD",
          "isSecret": true,
          "isRequired": true,
          "description": "SMTP password. Gmail App Password recommended."
        },
        {
          "name": "SMTP_FROM",
          "isRequired": true,
          "description": "Envelope From address for drafts emailed to the user's review inbox."
        },
        {
          "name": "GITHUB_TOKEN",
          "isSecret": true,
          "description": "Optional. Personal access token used to enumerate the user's public and private GitHub repos during catalog sync."
        },
        {
          "name": "HF_TOKEN",
          "isSecret": true,
          "description": "Optional. HuggingFace token used to enumerate the user's published models and datasets during catalog sync."
        },
        {
          "name": "GRAD_AGENT_HOME",
          "default": "~/.grad-agent",
          "description": "Optional. Override the default ~/.grad-agent/ location for profile, programs, secrets, and data."
        },
        {
          "name": "LOR_LETTERHEAD_PATH",
          "description": "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."
        },
        {
          "name": "LOR_LETTERHEAD_WIDTH",
          "default": "2.2in",
          "description": "Optional. LaTeX length for the letterhead image width (e.g. '2.5in'). Used only when LOR_LETTERHEAD_PATH is set."
        }
      ]
    }
  ],
  "repository": {
    "url": "https://github.com/i-ninte/grad-agent",
    "source": "github"
  },
  "description": "Autonomous MCP agent for grad school applications: prof discovery, cold emails, SOP, tracking."
}