{"openapi":"3.1.0","info":{"title":"Exam Format API","version":"0.1.0","description":"A standardized-test structural reference (SAT, ACT, GRE, GMAT, IELTS, TOEFL) with a real time-budget calculator and an approximate scaled-score estimator — all local.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://examfmt.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/examfmt/docs"},"termsOfService":"https://connectorbay.com/examfmt/terms"},"servers":[{"url":"https://examfmt.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/examfmt/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/list_exams":{"post":{"operationId":"list_exams","summary":"Lists the standardized tests this connector covers.","description":"Lists the standardized tests this connector covers.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_examsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/exam_structure":{"post":{"operationId":"exam_structure","summary":"Gives the full section-by-section structure of a standardized test: section names, question counts, per-","description":"Gives the full section-by-section structure of a standardized test: section names, question counts, per-\n    section timing, total time, and the scoring scale. Use for \"how many sections does the digital SAT have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"exam":{"description":"sat | act | gre | gmat | ielts | toefl","title":"Exam","type":"string"}},"required":["exam"],"title":"exam_structureArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/compare_exams":{"post":{"operationId":"compare_exams","summary":"Puts several exams side by side: section count, total questions, total time, and scoring scale. Use for","description":"Puts several exams side by side: section count, total questions, total time, and scoring scale. Use for\n    \"compare the SAT and ACT\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"exams":{"description":"Exam codes to compare.","examples":[["sat","act"]],"items":{"type":"string"},"maxItems":6,"minItems":2,"title":"Exams","type":"array"}},"required":["exams"],"title":"compare_examsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/section_time_budget":{"post":{"operationId":"section_time_budget","summary":"Computes a real per-question time budget (minutes and seconds per question) and pacing checkpoints at","description":"Computes a real per-question time budget (minutes and seconds per question) and pacing checkpoints at\n    25/50/75/100% of the questions, from a built-in exam/section or from a total_minutes/question_count you\n    supply. Use for \"how much time per question on the ACT English section\", \"I have 90 minutes for 60\n    questions, what's my pace\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"exam":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"sat | act | gre | gmat | ielts | toefl. Omit to use total_minutes/question_count instead.","title":"Exam"},"section":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A section name (partial match ok), e.g. 'english'. Omit for all required sections combined.","title":"Section"},"total_minutes":{"anyOf":[{"exclusiveMinimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Custom total minutes (used instead of exam/section).","title":"Total Minutes"},"question_count":{"anyOf":[{"exclusiveMinimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Custom question count (used instead of exam/section).","title":"Question Count"}},"title":"section_time_budgetArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/estimate_scaled_score":{"post":{"operationId":"estimate_scaled_score","summary":"Gives an approximate scaled-score estimate from a raw correct count, for exams/sections where a smooth","description":"Gives an approximate scaled-score estimate from a raw correct count, for exams/sections where a smooth\n    approximation is meaningful (SAT, ACT, IELTS Listening/Reading) — always labeled as an approximation, not an\n    official table. Honestly refuses (with `supported: false`) for GRE/GMAT/TOEFL, which are computer-adaptive\n    with no deterministic raw-to-scale relationship. Use for \"roughly what ACT score is 40 out of 50 on\n    English\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"exam":{"description":"sat | act | ielts (gre/gmat/toefl are refused: no deterministic table exists for adaptive tests)","title":"Exam","type":"string"},"section":{"description":"e.g. 'english', 'math', 'reading and writing', 'listening'.","title":"Section","type":"string"},"raw_correct":{"description":"Number of questions answered correctly.","minimum":0,"title":"Raw Correct","type":"integer"},"raw_total":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Total questions in the section, if different from the standard count.","title":"Raw Total"}},"required":["exam","section","raw_correct"],"title":"estimate_scaled_scoreArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/exam_glossary":{"post":{"operationId":"exam_glossary","summary":"Defines standardized-testing terms: composite score, band score, adaptive testing, CEFR, STEM score, raw","description":"Defines standardized-testing terms: composite score, band score, adaptive testing, CEFR, STEM score, raw\n    vs. scaled score, superscore, field test questions. Use for \"what's a composite score\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific term to look up; omit to list all.","title":"Term"}},"title":"exam_glossaryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}