For ChatGPT, Claude and your own agent
Your marked copies and the toppers, wherever you already work.
UPSC Grade is one MCP server. Link it once and ChatGPT, Claude, Cursor, Codex or an agent you build can open your marked answers, read what toppers wrote, search past questions and mark an answer you paste. Sign in with your UPSC Grade account; nothing is given without it.
The endpoint
https://api.upscgrade.com/mcp
Streamable HTTP. You link it with your UPSC Grade account: the app sends you to upscgrade.com to sign in with Google, you see what it will be able to do, and you press Allow. You can unlink it any time from the menu under your name.
For developers: OAuth 2.1 with PKCE, found from /.well-known/oauth-protected-resource/mcp. ChatGPT names itself by its client metadata document; other apps register themselves. Scopes: copies:read corpus:read judge saved:write practice:write account:read.
Link it from
ChatGPT
Plugins → + → Add custom MCP server. Paste the endpoint, choose OAuth, and create it. Sign in with Google and press Allow when it asks.
Claude.ai
Settings → Connectors → Add custom connector → paste the endpoint. Sign in with Google and press Allow when it asks.
Claude Code
One command, then /mcp and Authenticate. Your browser opens to sign in and allow it.
claude mcp add --transport http upsc-grade https://api.upscgrade.com/mcp
Cursor
Press the button, or add the server to your MCP config. The first time a tool needs you, it opens your browser to sign in.
{ "mcpServers": { "upsc-grade": { "url": "https://api.upscgrade.com/mcp" } } }Add to CursorCodex
Add the server to your MCP config with Streamable HTTP, then sign in when it asks.
{ "mcpServers": { "upsc-grade": { "type": "streamable-http", "url": "https://api.upscgrade.com/mcp" } } }Perplexity, Grok and Mistral
In the app's connector settings, add a custom connector and paste the endpoint. It sends you to upscgrade.com to sign in with Google and press Allow.
Your own agent
Any MCP client works the same way: it signs in as you, with OAuth, and gets only what you allow.
The tools
- list_my_copiesYour uploaded copies, newest first, with each one's total.
- get_marked_answerOne marked answer: the mark and every mark lost with its reason, the demands met and missed, the topper beside it.
- summarize_lost_marksAcross your copies: the rules you keep breaking and the demands you leave unaddressed.
- check_topper_pointsWhat toppers covered on a question, and which of those angles your answer had.
- compare_with_topperYour answer beside a topper's: opening, body, close, length, examples, and the demands you missed.
- suggest_next_questionsQuestions to write next, on the themes you lose marks on.
- save_questionKeep a question in your saved collection to come back to.
- get_my_accountYour account, your credits, and what the assistant has left for you today.
- search_mains_questionsUPSC's own Mains questions (2013 to 2026) by topic or wording, then test-series questions toppers answered.
- list_mains_themesThe papers and themes to choose from before picking questions to practise.
- get_random_topper_answerOne real topper's answer, picked at random: how they opened, built the body and closed.
- get_topper_answersReal toppers' answers to a question, each named with rank and year.
- mark_pasted_answerMark an answer you paste, the way a copy is marked. Spends one credit; on Free, 5 a day, shared with the assistant on the site.
- get_todays_questionToday's UPSC Mains question: one real GS question a day, the same for everyone.
- get_mains_questionOne Mains question in full: its parts, marks and word limit, and what it asks for as toppers answered it.
- get_answer_guideHow to write a UPSC Mains question: ways to open, frameworks for the body, ways to close, and the model answer.
- list_toppersThe toppers whose answer copies are on UPSC Grade: name, rank, year and papers.
- get_topper_copyOne topper's answer copy, answer by answer: each question and how the topper opened it.
- get_answer_rewriteOne of your marked answers rewritten with what was marked fixed, and each change explained.
- get_mains_progressYour Mains marks paper by paper over time, and the days you had answers marked.
- search_prelims_questionsUPSC's own Prelims questions by words, subject, topic or year, with the answer where the site shows it.
- start_prelims_quizA Prelims practice quiz from UPSC's past questions, kept in your account, answers hidden until you choose.
- check_prelims_answerYour option for a quiz question, marked: right or not, UPSC's answer and why, and for a statement question which options each statement rules out.
- get_prelims_progressYour Prelims accuracy by subject, the topics you miss most, and how much you've practised.
- get_current_affairs_briefOne day's current affairs for UPSC: what happened, the facts Prelims tests, the points for Mains.
- search_current_affairsIssues in the news by topic, across every day: when each was in the news and what it is.
- get_topic_trendsHow many questions each subject or theme got in each year's Prelims or Mains paper.
- list_saved_questionsYour saved lists and the questions in each.
- list_my_paymentsWhat you've paid and when, with each payment's invoice.
- get_credit_historyYour credits: how many are left, where they came from, when they end, and where they went.
Marks come only from a marked copy or from marking a pasted answer; the tools never estimate one. Toppers are real people, named with rank and year. The tools took names in the MCP standard’s verb-first style on 5 November 2026; from then their schemas only grow: a field or a tool is added, never renamed.
UPSC Grade is not part of, or connected to, the Union Public Service Commission. Its marks are not your UPSC score.