CertArc MCP server
For assistant developers and reviewers. The server gives free practice questions without an account, and read-only access to a learner’s own study after they connect their CertArc account. For learners, setup and availability are on Integrations.
Endpoints and transport
- ChatGPT:
https://certarc.com/mcp. A tool that needs an account returns an error result whose _meta["mcp/www_authenticate"] starts sign-in. - Claude:
https://certarc.com/mcp/claude. A tool that needs an account answers HTTP 401 with WWW-Authenticate. - Meta Muse:
https://certarc.com/mcp/muse. A tool that needs an account answers HTTP 401 with WWW-Authenticate. - Grok:
https://certarc.com/mcp/grok/account. Every request without a token answers HTTP 401 with WWW-Authenticate, so Grok asks for sign-in when the connector is added. - Grok, free practice:
https://certarc.com/mcp/grok. No sign-in; lists only the tools that work without an account.
Streamable HTTP: JSON-RPC 2.0 over POST with JSON responses. The server does not stream, so GET answers 405. Protocol versions: 2025-11-25, 2025-06-18, 2025-03-26. Methods: initialize, ping, tools/list, tools/call, resources/list and resources/read.
OAuth
- Authorization code with PKCE (S256). Each assistant is a registered public client: a client ID and exact callback URLs, no client secret, no dynamic registration.
- Discovery:
https://certarc.com/.well-known/oauth-authorization-serverand each signed-in endpoint’s protected-resource metadata, for examplehttps://certarc.com/.well-known/oauth-protected-resource/mcp/muse. - Scope
study:read. A request may name onlystudy:read,offline_access,openid,profile,email; the grant is always study:read, refresh tokens are always issued and no ID token is issued. The resource parameter is optional; tokens work only on the client’s own endpoint. - The learner signs in to CertArc with Google or a one-time email code, then approves read-only access on CertArc’s consent page. Access covers every certification they study on CertArc.
- Access tokens are short-lived and refresh tokens rotate on each use. A connection lasts up to 30 days. Learners disconnect at Connected assistants; clients revoke at
https://certarc.com/api/agents/revoke.
12 read-only tools
No tool changes a learner’s study data, sends messages, makes purchases, answers questions for the learner or changes their plan. CertArc records only when a connection last called a tool. Tools never return question text, options or answers from a learner’s sessions, or billing details. A missing readiness score means unknown, not zero.
Practice question
practice_question · Read · not sensitive · No account needed
Use this when someone wants CISM, CISSP, CISA, AAISM, or AAIA practice questions or sample exam questions, or asks for a quiz or to "test me". No account needed. Returns one scenario question from CertArc's free public practice set: the scenario, its options and a question ID, never the answer. The answer and CertArc's explanations come only from checking the learner's chosen option. Not for real exam questions.
program(required): one of cism, cissp, cisa, aaism, aaia. Certification: one of the released CertArc programs.position(optional): integer, from 1. Question number in the set; omit for the first.
Check practice answer
check_practice_answer · Read · not sensitive · No account needed
Use this when the learner has chosen an answer to a CertArc practice question. Returns whether it is correct, the correct option and CertArc's explanation for every option. A confident wrong answer is a blind spot. Does not record anything.
program(required): one of cism, cissp, cisa, aaism, aaia. Certification: one of the released CertArc programs.questionId(required): string, up to 64 characters.answer(required): string, up to 8 characters. Option key, such as A.confidence(optional): one of confident, unsure, guess.
Exam domains
get_exam_domains · Read · not sensitive · No account needed
Use this when someone asks what the CISM, CISSP, CISA, AAISM, or AAIA exam covers. No account needed. Returns the exam domains and their weights, with links to CertArc's public guides and, where it has one, its free practice set. Not for personal progress.
program(required): one of cism, cissp, cisa, aaism, aaia. Certification: one of the released CertArc programs.
Learning guides
search_learning_resources · Read · not sensitive · Works without an account; reads the connected account when there is one
Use this when someone asks for CertArc study guides on a topic. Returns published guide titles and links for one certification (the learner's latest when the account is linked). Never returns exam questions or answer keys. Not a general web search.
query(required): string, up to 200 characters. Words to match in guide titles; empty for all guides.program(optional): one of cism, cissp, cisa, aaism, aaia. Certification: one of the released CertArc programs.
Study overview
open_study_panel · Read · not sensitive · Needs a connected CertArc account
Use this when the connected learner wants to see their CertArc study overview: progress, saved schedule and next study option for one certification. Read-only. Not for another learner, exam answers or changing plans.
program(optional): one of cism, cissp, cisa, aaism, aaia. Certification to read. Omit for the one the learner studied most recently; every result names its certification and lists the learner's others.
Study patterns
get_study_patterns · Read · not sensitive · Needs a connected CertArc account
Use this when the connected learner asks why they miss questions, where their blind spots are, how their confidence matches their results, or which domains are weakest. Also use it for pace and timing questions. Returns domains weakest first with blind spots, knowledge-area results, Confident/Unsure/Guess against Correct/Incorrect, tagged miss reasons, and the dashboard's pace (average seconds a question against the exam pace, exam projection, rushing risk, slowest area, timing by knowledge area, confidence, domain and session) and practice activity (last practice date, practice days in the last 7 and 30 days, total practice time) for one certification. Study signals, not a pass prediction; never question content.
program(optional): one of cism, cissp, cisa, aaism, aaia. Certification to read. Omit for the one the learner studied most recently; every result names its certification and lists the learner's others.
Readiness and how to improve it
get_readiness · Read · not sensitive · Needs a connected CertArc account
Use this when the connected learner asks about their readiness score, how it is built, how to raise it, or which sprint or exam to retake for the most points. Returns CertArc's Readiness Score with its parts, the points Within reach on finished work and Still ahead in sessions not taken, the Improve your score steps with links to each module's results in CertArc, and the weekly readiness trend when CertArc has recorded it. A study measure, not an exam prediction.
program(optional): one of cism, cissp, cisa, aaism, aaia. Certification to read. Omit for the one the learner studied most recently; every result names its certification and lists the learner's others.
Sprint and exam results
get_results · Read · not sensitive · Needs a connected CertArc account
Use this when the connected learner asks how they did on sprints, practice exams, the baseline or the final assessment. Returns each completed one by its CertArc name with Take 1 and Take 2 scores (mode, correct, percent, date), the current composite, after a retake the movement (Breakthroughs, Persisted, Regressions, net change) and mastery, sessions in progress with answered counts, and what the Final Readiness Assessment still needs before it unlocks. Scores only; never questions.
program(optional): one of cism, cissp, cisa, aaism, aaia. Certification to read. Omit for the one the learner studied most recently; every result names its certification and lists the learner's others.
Result review
get_result_review · Read · not sensitive · Needs a connected CertArc account
Use this when the connected learner asks what happened in one sprint or exam: which answers were Incorrect, their confidence, miss reasons, domains, knowledge areas and time per answer, with that take's breakdown by domain, knowledge area, confidence, miss reason and pace, on a retake how each answer moved from Take 1 (Fixed, Slipped, Still missed, Right both times), whether the module can be retaken now (modes, what blocks it, when it unlocks) and the review still to do, as its CertArc result page decides. Takes a module as listed in the learner's results, and optionally take 1 or 2 (default latest). Answer facts only, never question text or answers; includes a link to the full review in CertArc.
module(required): string, up to 60 characters. Module identifier as listed in the learner's sprint and exam results, such as exam:practice_30:4.take(optional): one of 1, 2.program(optional): one of cism, cissp, cisa, aaism, aaia. Certification to read. Omit for the one the learner studied most recently; every result names its certification and lists the learner's others.
Study progress
get_study_summary · Read · not sensitive · Needs a connected CertArc account
Use this when the connected learner asks about their CertArc progress. Returns aggregate sprint progress, the target exam date and days to the exam, and the learner's access (Paid, Trial or None and the day it ends) for one certification. Never prices or payments; never for another person.
program(optional): one of cism, cissp, cisa, aaism, aaia. Certification to read. Omit for the one the learner studied most recently; every result names its certification and lists the learner's others.
Study calendar
get_study_plan · Read · not sensitive · Needs a connected CertArc account
Use this when the connected learner asks what to study today or this week, what is overdue, or what is on their CertArc calendar. Returns the calendar as CertArc shows it: every entry with its date and status (Completed, In progress, Overdue, Due today, Scheduled, Locked), the next session by the calendar's own rule, this week, overdue entries, counts, the plan start, exam date and days to the exam. Dates are in the learner's plan time zone. Does not change the plan.
program(optional): one of cism, cissp, cisa, aaism, aaia. Certification to read. Omit for the one the learner studied most recently; every result names its certification and lists the learner's others.
Next study option
get_next_study_action · Read · not sensitive · Needs a connected CertArc account
Use this when the connected learner asks what to study next in CertArc. Returns their CertArc assessment and its link while it is unfinished, otherwise the next eligible sprint in study order and a link to its domain; the calendar may recommend another. Does not start or complete a session.
program(optional): one of cism, cissp, cisa, aaism, aaia. Certification to read. Omit for the one the learner studied most recently; every result names its certification and lists the learner's others.
Errors and status
- HTTP 401 with WWW-Authenticate: a presented token is invalid or expired, on every endpoint except Grok’s free-practice endpoint, which ignores tokens; or (Claude and Meta Muse) a token is missing for a tool that needs an account; or (Grok) a token is missing on any request. Refresh the token or sign in again.
- HTTP 429 with Retry-After: rate limited. Wait the given seconds before retrying.
- HTTP 503: the service is temporarily unavailable. Retry later.
- HTTP 403: a browser request from another origin.
- HTTP 400, 406 or 415: invalid JSON, an unsupported protocol version, or a missing Accept or Content-Type header.
- JSON-RPC errors: -32700 invalid JSON, -32600 invalid request, -32601 unknown method, -32602 unknown tool or invalid arguments.
- Tool results with isError: on ChatGPT’s endpoint, a tool that needs an account was called without a token (with _meta["mcp/www_authenticate"]); CertArc can’t read the requested certification for this learner (the message says why and names the ones it can); or CertArc could not read the information. Tools change nothing, so a call can be retried.
- On Grok’s free-practice endpoint, a tool that needs an account returns a text result that points to Grok’s signed-in endpoint (
https://certarc.com/mcp/grok/account) and to CertArc.
Rate limits
- 120 requests a minute for each connected account.
- ChatGPT endpoint, calls without a token: 1,200 requests a minute from each IP address.
- Claude endpoint, calls without a token: 1,200 requests a minute from each IP address.
- Meta Muse endpoint, calls without a token: 1,200 requests a minute from each IP address.
- Grok endpoint, calls without a token: 1,200 requests a minute from each IP address.
- Grok, free practice endpoint, calls without a token: 1,200 requests a minute from each IP address.
Support and security
Email support@certarc.com for integration support and to report a security issue. Reviewers get a test account with their submission.