What would you like to understand?

Popular destinationsCalculatorsCoursesPracticeFormulas

Unlock Premium Help

Explore every tutor and study workspace for seven days, with no daily AI cap during the trial.

Choose a billing period
Ask a parent to pay

Nothing is charged during the first seven days. Unless you cancel, the plan you selected begins when the trial ends and renews on its stated schedule. Manage cancellation from your plan page. Stripe handles the payment details.

Developer API for Step-by-Step Math: Add It to Your App

There is no public API yet. Here are the three real /api/ routes, their access rules, examples, and limits.

The honest status

Plenty of sites publish an API page that describes something that does not exist yet. This one will not. Here is the real position: MATHGPTAI.NET has no public developer API. There is no key to request, no token to generate, no rate-limit tier to buy, and no sandbox. The routes under /api/ are real and they are documented below, but they exist to serve this website's own pages. They are blocked in robots.txt, they are locked to a browser session, and calling them from your own code will fail. If you want to build on top of the math, the honest first step is to email [email protected] and tell us what you would call, because right now that shapes the roadmap more than anything else.

Why the endpoints are locked down

Three reasons, and none of them are about being precious with the content.

  • Tutor requests use protected, rate-limited infrastructure. Authentication helps prevent abuse, preserve service availability, and keep saved work attached to the correct account.
  • The endpoints check a token that is only issued to a page loaded from this site, which stops another website calling them as you.
  • Without a stable, versioned response shape, anything you built would break the next time we improved the answer format.

What actually exists today

These three routes are the whole surface. The status column is the important one: "internal" means the route works only from a page on this site, with a valid session token. It is not a soft limit or a courtesy request; a call without the right token gets a 400 back and nothing else.

Every /api/ route on MATHGPTAI.NET today
MethodPathWhat it doesStatus
POST/api/solveTakes a typed problem, an image, or both, and returns a worked solution in Markdown.Internal. Needs a signed-in Google session and an X-CSRF-Token header.
POST/api/assessment-questionsGenerates a practice or test set for one course: each question has four choices, one correct index, a hint, and a worked solution.Internal. Needs an X-CSRF-Token header from a page on this site.
GET/api/healthReports whether the app is running and whether the solver is configured.Open. No key and no session needed, though robots.txt asks crawlers to skip it.

What a request and a response look like

Since you cannot call the internal routes yourself, here is exactly what the site sends and gets back, so you can judge whether the shape would be useful to you. The health check is the one you can try right now in a browser or with curl. The solve request is sent as a normal form post, which is what lets an image ride along with the text.

The one you can run

This works today, from anywhere, with no credentials.

  • curl https://mathgptai.net/api/health
  • It returns ok, which is true whenever the app is up.
  • It also returns solver_configured, which tells you whether the tutor has a working key behind it. When it is false, the solver returns a placeholder answer instead of a real one.
GET /api/health

200 OK
{
  "ok": true,
  "solver_configured": true
}
POST /api/solve
Content-Type: multipart/form-data
X-CSRF-Token: <token from the page's csrf-token meta tag>

problem = Solve 3x + 2 = 14
image   = <optional PNG, JPG, WEBP, or GIF, under 8 MB>

200 OK
{
  "answer": "## Understanding the problem\n...\n## Final answer\nx = 4\n## Check\n3(4) + 2 = 14\n..."
}
POST /api/solve  (not signed in)

401 Unauthorized
{
  "error": "Sign in with Google to use the AI tutor.",
  "login_url": "/auth/google?next=/solver"
}

Limits and errors

These are the limits the code enforces today. They apply to the site's own pages, and they are the numbers any future public interface would start from. The rate limits are counted per browser session over a rolling five-minute window, and a request that trips one comes back with a Retry-After header telling you how many seconds to wait.

Input limits

Anything outside these gets a 400 with a plain-English message rather than a stack trace.

  • A typed problem must be under 12,000 characters.
  • An image must be under 8 MB and under 25 megapixels.
  • An image must be a PNG, JPG, WEBP, or GIF, and must actually be a valid image file.
  • A generated question set must be between 1 and 15 questions.

Rate limits and status codes

The full set of responses you can get, so nothing is a surprise.

  • /api/solve: 30 requests per session in any five minutes.
  • /api/assessment-questions: 12 requests per session in any five minutes.
  • 400 for a missing or wrong CSRF token, an empty problem, a bad image, or invalid settings.
  • 401 when the solver is called without being signed in.
  • 404 when a course or unit does not exist.
  • 429 when a rate limit is hit, with a Retry-After header.
  • 502 or 503 when the AI provider fails or cannot be reached.

What we would build first

If and when a public interface happens, these are the things it would need before it deserved to be called stable, and they are also the questions we would ask you about your use case. Until then, the most useful thing you can do is describe what you would build. Send it to [email protected] with the volume you expect, the subjects you need, and how a learner in your product would see and question a wrong answer. Schools and learning platforms should also read the partnerships page, which sets out which kinds of collaboration are open right now and which are not. In the meantime, every public page and tool is free to link to, and the sitemap lists all of them.

The design rules any future version would follow

These come from what already goes wrong when AI output is dropped into a learning product.

  • Keep the learner's original problem visible next to the answer, unchanged.
  • Label which parts are generated and which parts are exact calculation.
  • Return the assumptions and the check step, not just the final line.
  • Give the learner a way to disagree with a step and see it another way.
  • Version the response shape, so an improvement never silently breaks your product.
  • Plan for the error cases before the happy path, because they will be a real share of traffic.

Questions about developer api for step-by-step math: add it to your app

How do I get an API key?

You cannot, because there are no API keys. There is no public developer programme, no waiting list, and no private beta running quietly in the background. If that changes, this page changes with it, since it is written from the routes that actually exist in the code.

Can I call /api/solve from my own app?

No. It requires a signed-in Google session and a CSRF token that is only issued to a page served by this site, so a request from your own code gets a 400 or a 401 rather than an answer. Trying to work around that is also against the terms of use.

Is scraping the site an acceptable alternative?

No, and the terms of use prohibit it. Automated traffic can overload protected endpoints and slow the site down for students. If you need something at scale, email [email protected] and describe it. A short honest description of a real use case gets further than a scraper does.

What can I use today, then?

Public learning pages and browser-based calculators are free to open and link to. Account features, AI tutor submissions, and optional Premium access have separate requirements. Point people at the calculators, the guides, or the formula library, and use the sitemap to find the exact page you want.

Need a direct answer?

Email [email protected]. Include the relevant page and only the information needed to understand the request.