DevelopersDocsStart
Introduction
Retrieve structured, allowlisted problems from Problems.cc. Mathematics is the subject that can return a problem today.
The Problems.cc API is a problem bank for educational products. You send a server-side REST or MCP request, and the response contains a statement, choices, images, topics, and the attribution line you need to display. It does not contain the answer.
This is a private technical beta. Access is an admin-issued key, and a key only receives explicitly allowlisted first-party problems. It is not a grading service, and it is not a dump of the public library. Using a key means you accept the Developer API beta terms.
API at a glance
| Item | Value |
|---|---|
| REST base URL | https://www.problems.cc/api/v1 |
| MCP URL | https://www.problems.cc/api/mcp |
| Auth | Authorization: Bearer $PROBLEMS_API_KEY |
| Subjects with classified problems | mathematics |
| Recognised subjects with no classified problems | quantitative_reasoning, physics, informatics, biology |
| Rating | maths_rating 400–4000 on mathematics. Other subjects are unrated. |
| REST routes | POST /problems/search, POST /problems/random, GET /problems/{id}, GET /catalog |
| MCP tools | search_problems, get_problem, get_catalog |
| Media base | https://www.problems.cc for markdown paths that start with / |
| Access | hello@problems.cc |
A first request
This searches the mathematics allowlist for one text-only problem, with no topic or rating filter. Run it from your server. The sample key variable is PROBLEMS_API_KEY.
Optional filters
Topic and rating filters are optional. The request below asks for number theory near a Maths Rating of 1800. During the private beta that can return 404 no_eligible_problem. That is an empty match, not a broken key. Use the broader request above first.
A matching allowlisted problem comes back as problems, plus selection and usage. The JSON below is a sample shape, written for these docs. The numbers in usage are not a plan or a quota. A live key reports its own limits.
{ : [ { : , : , : , : [ { : , : , : null }, { : , : , : null } ], : [], : [ { : , : } ], : , : , : , : , : [ { : , : } ], : { : }, : false, : , : { : null, : null, : null, : null, : null, : null }, : true } ], : { : , : , : , : false }, : { : , : , : , : , : , : , : }}rating_source is an opaque string from the active Maths Rating release. Common values include level_band and hierarchical_prior. When rating_confidence is low, that number is a prior, not an empirically validated rating. Read both fields before you treat it as a measured difficulty.
What a response leaves out
- The correct choice, the answer, and the solution. You cannot grade from this API.
- Problems that an admin has not allowlisted for redistribution.
- Interactive problems. Those stay on the Problems.cc site.
- A public count of how many problems a subject contains. Catalog counts are per key.
Continue with the quickstart, MCP setup, or subjects before you filter on anything other than mathematics.