API and MCP server
Use ProvenDecisions from your own programs and from AI assistants. The API takes a model as typed math or LaTeX and returns the answer as JSON; the MCP server gives the same solver to Claude and other assistants, so they quote checked numbers instead of guessing. Both are included in the Standard and Pro plans. Full examples are on the Developers page.
Plans that include it
- Standard and Pro plans, and group seats that get the Standard or Pro plan.
- Free and Student plans (and Academic seats, which get the Student plan) stay web-only. The Settings screen says so and links to the plans.
Getting a key
- Sign in and open Settings.
- Under API keys, type a name (for example "laptop script") and choose Create key.
- Copy the key at once: it is shown only once. We keep only a scrambled copy (a hash), so nobody, not even us, can show it again. If you lose it, revoke it and make a new one.
You can have up to 5 keys at a time. Revoke stops a key at once. Keys are personal: do not share them or put them in public code.
What you can send
- Typed math or LaTeX only, for now, the same as the Math box in the app:
maximize 3*a + 2*b, thensubject toand one constraint per line. Word, photo and voice problems are solved in the web app; the API answers them with a clear "typed math only" message. - One problem per request, up to 3,000 characters. Vector syntax (
var x[100]) is part of Pro, as on the website.
What comes back
The same answer as the app: the solver's status, the objective, the solution, the check of every constraint, the dual or KKT check, the proof label (for example "Exactly proven optimal"; see Reading an answer) and the walkthrough steps at the depth you ask for (1 to 10). Separate calls give the dual of a linear program and the KKT (Lagrange multiplier) certificate of a smooth problem.
For an MCP assistant the tools are solve, dual, kkt and explain (the walkthrough as text).
Connecting from claude.ai
On claude.ai and in the Claude apps you connect by signing in, with no key to copy:
- In Claude, open Settings, then Connectors, and choose Add custom connector.
- Name it ProvenDecisions and enter
https://proven-decisions.ai/mcp. Keep the choices Claude marks Detected: Sign in now (Authentication) and Register automatically (OAuth client). Add no request headers and leave Advanced closed. - Choose Connect. A ProvenDecisions page opens; sign in if asked.
- It asks: "Allow Claude to use ProvenDecisions on your account?" Choose Allow, and you are back in Claude with the connector on.
The same plans (Standard and Pro), limits and typed-math rule apply as for a key. Claude stays connected while you use it (its access renews by itself; after 30 days without use, connect again). Under Settings, Connected apps you see each connected app, when it was connected and last used; Disconnect stops it at once. On a Claude Team or Enterprise plan, an owner adds the connector for the organization first. Claude Desktop can also use a key; see the Developers page.
Connecting from Claude Code
Claude Code (in the terminal or in VS Code) signs in the same way, with no key:
- In a terminal, run
claude mcp add --transport http --scope user proven-decisions https://proven-decisions.ai/mcp(--scope usermakes it available in every project). If the terminal saysclaude: command not found, install Claude Code's terminal command first with Anthropic's installer (see Claude Code's own setup guide). - Start a new Claude Code session and type
/mcp. Choose proven-decisions, then Authenticate. - Your browser opens the ProvenDecisions page; sign in if asked and choose Allow. Claude Code shows "Authentication successful".
To use a key instead (for example on a server with no browser), add --header "Authorization: Bearer pd_live_..." to the command in step 1 and skip steps 2 and 3.
Reading the site's content
The API and the MCP server also read everything on the site, without a model call and without using up your solves:
GET /api/v1/content/search?q=...searches tutorials, refreshers, solved examples, Help, the Daily Update, New in AI, Update On Demand reports and the Glossary at once (POSTwith{"q": ...}keeps your search words out of web addresses).GET /api/v1/tutorials(add?section=refreshersfor the calculus Refreshers) andGET /api/v1/tutorials/<slug>: the tutorial as Markdown with the math as LaTeX, plus links to its page and PDF.GET /api/v1/examplesand/api/v1/examples/<slug>: the problem, the model, the solver's checked answer with its proof label, and the walkthrough.GET /api/v1/daily(withfromandtodates, YYYY-MM-DD),/api/v1/posts(New in AI),/api/v1/help,/api/v1/reportsand/api/v1/glossary(each term and its definition), each with/<slug>for one item.- Lists come in pages:
limit(1 to 100, default 20) andoffset; the answer givesnext_offsetuntil the last page. - For an MCP assistant:
search_content,get_contentandlist_content.
The website's rules apply: a tutorial above your plan is listed as locked and not served (a Standard key reads Free, Student and Standard tutorials; Pro reads all), and the Daily Update covers the last 365 days, as for a signed-in user. Every endpoint, with examples, is in the API reference; programs can read the OpenAPI document.
Limits
API and MCP requests use the same limits as the website, counted together for your account. Solving: 5 requests a minute, 100 a day and 1,000 a month; one problem at a time; 10 minutes of solving a day; and the monthly 85% stop (see Plans and limits). Reading content: the lighter limit the website uses for searches, 30 requests a minute and 1,000 a day. A script cannot do more than you can in the app. When a limit is reached the API answers with code 429 and says which limit and when it resets.
Privacy
Requests are handled like problems typed into the app (see Privacy in plain words). Keys, and the sign-ins of connected apps, are stored only as a hash, with the date each was made and last used.
Try ProvenDecisions free: type, photograph or say an optimization problem; every answer is checked by a solver.