grad-agent
Autonomous MCP agent for grad school applications: prof discovery, cold emails, SOP, tracking.
Connector by i-ninte · GitHub account verified by the MCP Registry
Install
Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.
npx agentmarket install connector/i-ninte-grad-agent
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.
- Tools
- 10 read · 18 write · 2 delete · 8 not yet classified
- Secrets
- 4 (API keys, tokens or passwords)
- Install scripts
- None found
- Runs as
- Python package
Tools by what they do 38
Read from the source code; the running server may list different tools.
Read 10 · Look things up without changing anything.
discover_profsfind_prof_pageget_letterheadlist_pipelinelist_postslist_programslist_projects_in_cataloglist_scholarshipsoutreach_log_viewskipped_log_view
Write 18 · Create, change, send or run things.
add_targetdraft_articledraft_cold_emaildraft_sopingest_repliesinstall_skillslor_addlor_markmark_statusoutreach_mark_followupoutreach_mark_responseoutreach_mark_sent
Show 6 more tools
publish_articlerun_daily_batchsend_draft_to_meset_letterheadsync_catalogupdate_article
Delete 2 · Delete, drop, revoke or wipe things.
delete_postrun_program_batch
Not yet classified 8 · We could not tell from the name and description.
followups_dueinterview_prepload_profilelor_outstandingoutcome_reports2_cache_invalidateupcoming_deadlinesupcoming_scholarship_deadlines
Secrets and settings it asks for
Secrets: values you paste in that let it act as you.
ANTHROPIC_API_KEYGITHUB_TOKENHF_TOKENSMTP_PASSWORD
Other settings (environment variables or headers).
GRAD_AGENT_HOMELOR_LETTERHEAD_PATHLOR_LETTERHEAD_WIDTHSMTP_FROMSMTP_PORTSMTP_SERVERSMTP_USERNAME
Network hosts it talks to 20
api.github.com· found in codeapi.semanticscholar.org· found in codeapi2.openreview.net· found in codearxiv.org· found in codechevening.org· found in codecscuk.fcdo.gov.uk· found in codeeacea.ec.europa.eu· found in codeexport.arxiv.org· found in codeforeign.fulbrightonline.org· found in codegatescambridge.org· found in codegithub.com· found in codehtml.duckduckgo.com· found in codehuggingface.co· found in codei-ninte.github.io· found in codei-ninte.vercel.app· found in codeknight-hennessy.stanford.edu· found in codemastercardfdn.org· found in codeopenreview.net· found in coderhodeshouse.ox.ac.uk· found in codevanier.gc.ca· found in code
Files it touches
~/.claude/skills/Users/ninte/Desktop/NINTE/Users/ninte/Desktop/NINTE/bbfship/Users/ninte/Desktop/NINTE/credit-unions-solution-client/Users/ninte/Desktop/NINTE/credit-unions-solution-server/Users/ninte/Desktop/NINTE/dataocean_backend/Users/ninte/Desktop/NINTE/deriv-rag/Users/ninte/Desktop/NINTE/DEV2WINN/Users/ninte/Desktop/NINTE/ecoscan/Users/ninte/Desktop/NINTE/geoforest/Users/ninte/Desktop/NINTE/GhanaNLP-data-models-play/Users/ninte/Desktop/NINTE/Kyini/Users/ninte/Desktop/NINTE/sikacircle/Users/ninte/Desktop/NINTE/skyrush/Users/ninte/Desktop/NINTE/tccu/Users/ninte/Desktop/NINTE/tillmate- Your home directory (~)
~/.grad-agent- Any path the agent passes to its tools
Tools (38)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
add_targetdelete_postdiscover_profsFan out arXiv + OpenReview for recent papers in `area` (nlp|llm|ml|cv|ai4health|africa or raw query). Returns candidates with authors as prof leads.
draft_articleDraft a blog post from a project under NINTE_ROOT.
draft_cold_emailDraft a cold email. Saves to drafts/, returns preview + banned_hits.
draft_sopDraft a Columbia-style SOP and compile to PDF. Returns {tex, pdf}.
find_prof_pageWeb search for a professor's lab page / email.
followups_dueProfs emailed `days`+ ago with no reply and no nudge yet, each with a drafted follow-up ready to review and send.
get_letterheadReturn the currently configured letterhead settings from ~/.grad-agent/.env.
ingest_repliesRead-only IMAP scan: detect professor replies and tag the outreach log. Needs IMAP creds in .env (defaults to Gmail + SMTP credentials).
install_skillsSymlink the bundled `lor-writing` and `sop-writing` skills into ~/.claude/skills/ so Claude Code / Claude Desktop pick them up. Falls back to copy on filesystems without symlink support (Windows without developer mode). Existing symlinks are refreshed; existing real directories are skipped unless `force=True`. Args: target: override destination dir (default: ~/.claude/skills). force: replace existing non-symlink entries with the same name.
interview_prepGenerate a one-page interview brief for a prof who replied: their recent papers summarised, likely questions, your talking points, questions to ask.
list_pipelinestatus: '' (all) | new | drafted | sent | replied | rejected | silent
list_postsList all posts on the portfolio (published + drafts).
list_programs
Show 23 more tools
list_projects_in_catalogReturn the current unified catalog (seed + synced).
list_scholarshipsExternal scholarships from scholarships.yaml, optionally filtered by eligibility region (US, Canada, UK, EU, Asia, Africa, Australia).
load_profileLoad and cache CV + transcript. Call once per session.
lor_addlor_marklor_outstandingmark_statusoutcome_reportResponse-rate report from your tagged outcomes: totals, by area, by project.
outreach_log_viewShow the last N rows of the outreach xlsx.
outreach_mark_followupRecord that you sent the follow-up nudge, so the prof is never nudged twice.
outreach_mark_responseTag a prof's reply. outcome: positive | negative | no_response | interview. These tags feed the matcher: projects that earn replies rank up in future runs.
outreach_mark_sentpublish_articlePOST a markdown article to the portfolio (converts md→html). Draft by default.
run_daily_batchRun the daily outreach: pick n unseen profs in `area` (or today's rotation), match to your strongest project, draft dashless cold emails, log to xlsx, and email the batch to your review inbox.
run_program_batchDeadline-driven batch: verify + draft for faculty of one program from programs.yaml instead of arXiv discovery. Use before application deadlines.
s2_cache_invalidateSelectively purge the Semantic Scholar cache. `query` matches author names and ids (substring). Use everything=True to wipe the whole cache. Use after a prof's S2 record changes (new affiliation, merged record).
send_draft_to_meEmails the draft file to your inbox (NOTIFY_TO).
set_letterheadSet (or clear) the letterhead / company logo used when compiling a Letter of Recommendation to LaTeX. Writes LOR_LETTERHEAD_PATH and (optionally) LOR_LETTERHEAD_WIDTH into the user's dotenv at ~/.grad-agent/.env. Pass `path=""` to clear it (next compile emits a plain top block the recommender can paste onto their own letterhead). This is the recommended way to swap letterheads per recommender. Args: path: absolute path to the letterhead image (.png / .jpg / .pdf). Empty string clears the setting. width: optional LaTeX length for the letterhead (e.g. "2.5in"). Empty str…
skipped_log_viewAudit trail of skipped leads: who was rejected, at which stage (identity / faculty-gate / region / dedup / no-papers), and the specific mismatch that failed (e.g. 'identity ambiguous: 2 comparable candidates').
sync_catalogExtend the project catalog. source in {all, github, huggingface, local}.
upcoming_deadlinesupcoming_scholarship_deadlinesupdate_articleUpdate an existing post in place (converts md→html).
Signals
- Stars
- 4
- Forks
- 1
- Open issues
- 0
- Weekly downloads
- 89
- Last commit
- Sep 25, 2026 (1 month ago)
- Last release
- Sep 25, 2026 (1 month ago)
- Last package publish
- Sep 25, 2026 (1 month ago)
From GitHub (fetched Oct 24, 2026) and the package registry.
Details
- Registry name
io.github.i-ninte/grad-agent- Version
- 0.2.9
- Auth
- API key
- Packages
- pypi grad-agent
- License
- MIT
- Repository
- github.com/i-ninte/grad-agent
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
Cite this page
grad-agent MCP server. Agent Mart. https://agentmart.dev/connectors/i-ninte-grad-agent (last updated 2026-10-24)