NexStudy MCP Server
Connect Cursor, Claude, or any MCP-compatible agent to India's most comprehensive study-abroad dataset. 23 tools covering university discovery, IELTS requirements, loan offers, application tracking, and IELTS training courseware — all over JSON-RPC 2.0 with Bearer JWT auth.
23
tools
23
audit-logged calls
60
calls / min / token
4
auth scopes
Endpoints
| Method | Path | Description |
|---|---|---|
| POST | /api/mcp | JSON-RPC 2.0 message dispatch (tools/call, tools/list, initialize, ping) |
| GET | /api/mcp/manifest | Human-readable manifest with full tool catalog, auth guide, and code snippets. Cached 1h. |
| GET | /api/mcp/health | Liveness check — returns { ok, toolCount, version }. Used by smoke suite. |
| GET | /.well-known/mcp.json | MCP directory listing standard — points crawlers to the server endpoint. |
Authentication
Pass your NexStudy JWT in the Authorization: Bearer header. Anonymous sessions can call all anonymous scope tools without a token — no sign-up required for read-only university and outcome-stats queries.
anonymous
No token required. University search, outcome stats, catalog reads.
student
Student JWT. Profile reads, shortlist, training, applications.
counselor
Counselor JWT. Session management, outcome entry.
admin
Admin JWT. Full access including audit log reads.
Get a token
# Student login
curl -s -X POST https://api.nexstudy.in/api/student-auth/login \
-H 'Content-Type: application/json' \
-d '{"email":"you@example.com","password":"••••••••"}' | jq .accessToken23 tools — grouped by capability
All tools are invoked via tools/call. The scope badge shows the minimum auth level required.
University Discovery
3 toolsSearch and explore 1,600+ universities across 10 countries.
search_universitiesFull-text + country + IELTS filter search across the catalog.
anonymousget_universityFull profile for a single university by slug or ID.
anonymouslist_courses_for_universityAll available programs for a university with fees and deadlines.
anonymous
Student Profile & Shortlist
2 toolsRead and update a student's profile and university shortlist.
get_student_profileReturns the authenticated student's profile, scores, and shortlist.
studentsubmit_shortlistAdd or replace a student's university shortlist.
student
Counseling & Loans
2 toolsRequest counselor sessions and surface loan offers.
request_counselor_sessionBook a counselor session slot.
studentget_loan_offersRetrieve personalised education loan offers from partner banks.
student
Application Tracking
1 toolsRecord and track application status changes.
track_applicationCreate or update an application-stage record for a university.
student
Outcome Data
2 toolsRecord admissions outcomes and query outcome statistics.
record_outcomeRecord an admissions result (OFFERED / REJECTED / WAITLISTED / ENROLLED).
studentquery_outcome_statsAggregate acceptance rates and offer counts by country / university / score band.
anonymous
Training / Courseware
13 tools13 tools powering the IELTS training engine — study plans, mastery, SRS, mock debrief.
list_test_catalogList all available IELTS practice test types.
anonymousget_test_catalog_entryFull metadata for a single test catalog entry.
anonymousget_mastery_snapshotPer-skill mastery scores for the authenticated student.
studentrecord_item_attemptRecord a practice-item attempt (updates mastery model).
studentpick_next_itemSpaced-repetition recommendation for the next item to practice.
studentget_today_planToday's study plan with completion status.
studentcreate_study_plan_v2Generate or replace a study plan towards a target score and date.
studentcomplete_activityMark a plan activity as complete and record time spent.
studentget_srs_dueFetch SRS cards due for review today.
studentreview_srs_cardSubmit an SRS card review (ease rating 1-5).
studentget_avatar_presentationRetrieve Nex Avatar video/audio for a given lesson intent.
studentgenerate_micro_explanationLLM-generated 2-sentence explanation for a vocabulary or grammar point.
studentgenerate_mock_debriefPost-mock debrief with IELTS-band feedback and targeted drills.
student
Quick-start
cURL examples
# 1. List all tools (no auth needed)
curl -s -X POST https://api.nexstudy.in/api/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | jq .result.tools[].name
# 2. Search universities (anonymous)
curl -s -X POST https://api.nexstudy.in/api/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_universities","arguments":{"query":"computer science Canada","ieltsMin":6.5,"limit":5}}}'
# 3. Query outcome stats (anonymous)
curl -s -X POST https://api.nexstudy.in/api/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"query_outcome_stats","arguments":{"country":"Canada","degreeLevel":"Masters"}}}'Use inside Cursor
Add the following to your project's .cursor/mcp.json (requires Cursor 0.44+):
// .cursor/mcp.json — add to your Cursor project
{
"mcpServers": {
"nexstudy": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://api.nexstudy.in/api/mcp"],
"env": {
"NEXSTUDY_JWT": "<your_student_or_counselor_jwt>"
}
}
}
}Claude Desktop
Add the same mcpServers.nexstudy block to ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.
Rate limits & SLA
Requests / minute
60 / token (sliding window)
Batch size
Up to 10 requests per POST body
Response SLA
< 800ms p99 for read tools; < 3s for LLM tools
All tool calls are audit-logged to MCPAuditLog. Rate-limited requests return JSON-RPC error code -32018. Contact api@nexstudy.in for higher limits.