Lets an AI client compute precise mathematical results, render interactive 2D/3D visualizations, and generate 3D shape nets and slideshows.
Also known as architectds/mathgraphs-mcp
- Stars
- 0
- Tools
- 42
- Downloads, 30 days
- —
- Latest version
- 1.0.0
- Last commit
- Oct 3, 2026
- License
- MIT
What is MathTalking MCP?
MathTalking lets an AI client compute precise mathematical results, render interactive 2D/3D visualizations, and generate 3D shape nets and slideshows. It exposes 42 tools, such as function, points, segment.
Summary generated from the project's README
About MathTalking MCP server
Visualizing complex mathematical concepts and building 3D environments is what mathgraphs-mcp enables for developers using AI clients. It provides a way to move beyond text-based math by generating interactive 2D graphs, precise numerical analyses, and immersive 3D scenes. Instead of relying on an AI to guess coordinates, this server uses a dedicated engine to compute exact roots, extrema, intersections, and integrals, returning both the numerical data and shareable interactive URLs.
Users can connect this server to Claude Desktop or Claude Code via a remote HTTP transport without needing an account or API key. The toolkit includes specialized functions like net_generator for creating printable 2D nets of 3D shapes, plot_3d for constructing scenes with lights and particles, and create_show to bundle multiple graphs into a navigable slideshow. Every result is browser-native, providing zoomable, pannable visualizations that can be embedded or viewed as standalone interactive pages.
What you can do with it
- 1Verify mathematical propertiesAsk the client to find the exact roots and local extrema of a specific function.
- 2Generate printable geometry modelsRequest a 2D net for a cylinder or cube including its volume and surface area.
- 3Construct 3D environmentsInstruct the AI to build a 3D scene containing a house, trees, and a campfire.
- 4Create math presentationsCombine several different function plots into a single interactive slideshow.
Written from the project's README. Every use case is checked against a quote from it.
How to install MathTalking MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall MathTalking MCP in Claude Code
$ claude mcp add mathgraphs-mcp -- npx -y mathgraphs-mcpInstall MathTalking MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mathgraphs-mcp": {
"command": "npx",
"args": [
"-y",
"mathgraphs-mcp"
]
}
}
}Install MathTalking MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mathgraphs-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mathgraphs-mcp"
]
}
}
}Install MathTalking MCP in VS Code CLI
$ code --add-mcp '{"name":"mathgraphs-mcp","type":"stdio","command":"npx","args":["-y","mathgraphs-mcp"]}'Install MathTalking MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mathgraphs-mcp": {
"command": "npx",
"args": [
"-y",
"mathgraphs-mcp"
]
}
}
}Install MathTalking MCP in Codex
$ codex mcp add mathgraphs-mcp -- npx -y mathgraphs-mcpInstall MathTalking MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mathgraphs-mcp] command = "npx" args = ["-y", "mathgraphs-mcp"]
Install MathTalking MCP in Gemini CLI
$ gemini mcp add -s user mathgraphs-mcp npx -- -y mathgraphs-mcpInstall MathTalking MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mathgraphs-mcp": {
"command": "npx",
"args": [
"-y",
"mathgraphs-mcp"
]
}
}
}MathTalking MCP tools 42
Detected from the READMEfunctionpointssegmentlabeltriangleboxcircleviewporttitlesummarygridStyleoutput
| function | — | |
| points | — | |
| segment | — | |
| label | — | |
| triangle | — | |
| box | — | |
| circle | — | |
| viewport | — | |
| title | — | |
| summary | — | |
| gridStyle | — | |
| output | — |
Show all 42 toolsShow fewer tools
animationsthemebase_render_idremove_indicestyperootsextremainflectionsintersecttangentnormalderivativeintegralarea_betweenarc_lengthclosest_pointshapecubesquare_pyramidtriangular_prismrectangular_prismmeshcompoundsurfacelightparticlewaterline3dlabel3dtext3d
| animations | — | |
| theme | — | |
| base_render_id | — | |
| remove_indices | — | |
| type | — | |
| roots | — | |
| extrema | — | |
| inflections | — | |
| intersect | — | |
| tangent | — | |
| normal | — | |
| derivative | — | |
| integral | — | |
| area_between | — | |
| arc_length | — | |
| closest_point | — | |
| shape | — | |
| cube | — | |
| square_pyramid | — | |
| triangular_prism | — | |
| rectangular_prism | — | |
| mesh | — | |
| compound | — | |
| surface | — | |
| light | — | |
| particle | — | |
| water | — | |
| line3d | — | |
| label3d | — | |
| text3d | — |
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablearchitectds/mathgraphs-mcp is public and reachablegithub.com/architectds/mathgraphs-mcp ↗Pass
- Package names this repository as its sourcemathgraphs-mcp names architectds/mathgraphs-mcp as sourcenpmjs.com/package/mathgraphs-mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-03github.com/architectds/mathgraphs-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from mathgraphs-mcpPass
- No critical advisory in the package or its dependencies1 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model42 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubmathgraphs-mcp
MCP server for interactive math graphing, 3D scene building, and presentations.
MathTalking computes and renders interactive visualizations. Plot 2D functions, geometry, and 3D scenes. Results are graph-verified — roots, extrema, and intersections are computed from actual plotted curves, not generated by AI.
Zero install. Browser-native. Every result is a shareable interactive URL.
Quick Start
Claude Desktop
Settings → Connectors → Add custom connector → paste:
https://mathtalking.com/api/mcp
No account or API key needed.
Claude Code
claude mcp add --transport http mathtalking https://mathtalking.com/api/mcp
Any MCP Client
POST https://mathtalking.com/api/mcp
Content-Type: application/json
Standard JSON-RPC 2.0 over Streamable HTTP.
Tools
plot_graph — 2D Math Visualization
Plot functions, points, segments, labels, and shapes on an interactive graph. Auto-computes roots, extrema, and intersections for plotted functions.
Input: Array of elements, each with a type and type-specific fields:
| Type | Fields | Example |
|---|---|---|
function |
expression (required), color |
{"type":"function", "expression":"x^2-4", "color":"#4A90D9"} |
points |
points [{x,y}] or [[x,y]] (required), color, label |
{"type":"points", "points":[{"x":2,"y":0}], "label":"root"} |
segment |
x1,y1,x2,y2 (required), color, label, arrow, dashed |
{"type":"segment", "x1":0, "y1":0, "x2":3, "y2":4, "label":"hypotenuse"} |
label |
text (required), x,y (required), color, fontSize |
{"type":"label", "text":"vertex", "x":0, "y":-4} |
triangle |
x1,y1,x2,y2,x3,y3 (required), color, opacity, border |
{"type":"triangle", "x1":0, "y1":0, "x2":3, "y2":0, "x3":3, "y3":4} |
box |
x1,y1,x2,y2 (required), height (required), color, opacity |
{"type":"box", "x1":0, "y1":0, "x2":1, "y2":0, "height":5} |
circle |
cx,cy,radius (required), color, opacity, border |
{"type":"circle", "cx":0, "cy":0, "radius":3} |
Supports: Explicit y=f(x), implicit x²+y²=1, parametric (cos(t),sin(t)), polar, piecewise, domain restrictions.
Optional params:
viewport—{xmin, xmax, ymin, ymax}. Set it to your data's own magnitude; values far outside the range are invisible. Omit it and the server auto-fits the window to your elements.title— graph titlesummary— frosted glass overlay text on the graphgridStyle—"polar"(concentric circles + radial lines),"axes"(axes only),"none"(clean canvas)output—"url"(default, interactive page),"embed"(iframe URL), or"svg"(vector image)animations— array of{tool, name, from, to, loop}for animated parameterstheme—"default","terminal","wallstreet","science", or"finance"base_render_id— build on an existing render instead of re-sending every elementremove_indices— drop elements from the base render by index (seeget_graph)
Returns: Interactive URL with zoom, pan, and sliders. Auto-computed roots, extrema, and intersections in the response text, plus a graph check reporting anything that did not render properly — unreadable expressions, off-screen elements, duplicates, or a blank graph.
analyze — Precise Numerical Results
Compute exact values with the graph engine instead of doing the arithmetic in the model. Returns numbers, not a picture.
Input: type and f (both required), plus whichever fields that analysis needs:
type |
Extra fields | Returns |
|---|---|---|
roots |
a, b (range, default -10..10) |
x-values where f crosses zero |
extrema |
a, b |
local minima and maxima |
inflections |
a, b |
points where concavity flips |
intersect |
g (second expression), a, b |
where f and g cross |
tangent |
x (point of interest) |
tangent line at x |
normal |
x |
normal line at x |
derivative |
x |
f'(x) |
integral |
a, b |
definite integral over [a, b] |
area_between |
g, a, b |
area between the two curves |
arc_length |
a, b |
curve length over [a, b] |
closest_point |
px, py |
point on f nearest to (px, py) |
Supports: explicit, parametric, polar, and implicit curves. For parametric curves x is the t value.
Draw the result: add plot: true (and an optional title) to get an interactive graph URL and thumbnail with the answer already marked — roots and intersections as labelled points, tangent and normal as lines, closest_point joined to its target, integral and arc_length with their bounds on the curve. Saves transcribing coordinates into a second plot_graph call. The linear-algebra types ignore it.
Example: {"type":"intersect", "f":"x^2-4", "g":"2x-1", "plot":true}
get_graph — Inspect a Graph
Retrieve the elements and viewport of an existing 2D render. Element indices come back in order, so you can pass them to remove_indices.
Input: render_id (the 10-character code in a plot_graph URL).
Returns: element list, viewport, and a one-line summary of what the graph holds.
net_generator — Shape Nets, Volume & Surface Area
Unfold a solid into its printable 2D net, with the measurements worked out.
Input: shape (required) and dims:
shape |
dims |
|---|---|
cylinder, cone |
r, h (cone also accepts r + slant) |
cube |
a |
square_pyramid |
a (base edge), h |
triangular_prism |
a (base edge), l (length) |
rectangular_prism |
w, h, d |
tetrahedron, octahedron, icosahedron, dodecahedron |
a (edge) |
Spelled-out keys work too (radius, height, side, width, depth, length). Give every dimension the shape needs — a partial set is rejected, so a mistyped key cannot quietly produce the wrong net. Omit dims entirely to get an example at default sizes; the reply says when it did that.
Optional: unit (cm | m | in | ft), title, output (url | embed | svg).
Returns: the net as an interactive URL and thumbnail, plus volume, surface area, and the substituted formulas.
Example: {"shape":"cylinder", "dims":{"r":3,"h":5}, "unit":"cm"} → volume 141.37 cm³, surface area 150.80 cm², printable net.
A sphere has no planar net — use plot_3d for spheres.
plot_3d — 3D Scene Builder
Create interactive 3D scenes with shapes, lights, and particle effects. Build anything — snowmen, castles, robots, geometry.
Input: Array of elements, each with a type and type-specific fields:
| Type | Fields | Example |
|---|---|---|
mesh |
shape (required), color, opacity, position, rotation, metalness, roughness, wireframe |
{"type":"mesh", "shape":"sphere", "r":1, "metalness":0.8, "position":[0,1,0]} |
compound |
compound (required), position, scale, color |
{"type":"compound", "compound":"house", "color":"#cc2222", "position":[0,0,0]} |
surface |
expression (required), color, xmin, xmax, ymin, ymax, resolution |
{"type":"surface", "expression":"sin(x)*cos(y)", "color":"#4A90D9"} |
light |
kind (point/spot/directional), color, intensity, position |
{"type":"light", "kind":"point", "color":"#ff8800", "position":[0,5,0]} |
particle |
preset (fire/smoke/rain/snow/sparkle/mist/splash), position, count, spread |
{"type":"particle", "preset":"fire", "position":[3,0,0]} |
water |
position, size, waveHeight, color, opacity |
{"type":"water", "position":[0,0,0], "size":10} |
line3d |
from [x,y,z], to [x,y,z], color |
{"type":"line3d", "from":[0,0,0], "to":[1,1,1]} |
label3d |
text, position [x,y,z] |
{"type":"label3d", "text":"origin", "position":[0,0,0]} |
text3d |
text, position [x,y,z], color, fontSize |
{"type":"text3d", "text":"HELLO", "position":[0,2,0], "color":"#ff0000", "fontSize":1} |
11 mesh shapes: cube, box, sphere, cylinder, cone, tetrahedron, octahedron, dodecahedron, icosahedron, torus, prism
36 compound presets: tree, house, castle_tower, fence, campfire, rock, stairs, arch, table, chair, person, car, road_sign, windmill, dog, cat, flag, bed, sofa, bookshelf, lamp, desk, bush, flower, bridge, lamp_post, bench, apartment, skyscraper, shopping_center, hospital, ambulance, truck, boat, traffic_light, water_tower, fountain
Color-driven building styles: Buildings change architectural style based on color — red=Chinese, blue=modern, yellow=cozy, green=eco, brown=rustic. The actual hex color is used for materials; the hue just selects the geometry variant.
Shape params: cube→size, box→width/height/depth, sphere→r, cylinder→r/h, cone→r/h, torus→r/tube, prism→points/h
Material params: metalness (0=plastic, 1=chrome), roughness (0=mirror, 1=matte), wireframe (boolean)
Animation: animate: {type, speed, ...} — spin, bounce, orbit, waypoint, follow (tracks player)
Physics & controls: physics: {velocity, mass}, controls: {type:"wasd", speed}, collision: true
Incremental building:
base_render_id— build on an existing scene (appends elements, creates new URL)remove_indices— remove elements by index from base (useget_3dto see indices)
Optional: title, summary, camera {position, target}, skybox (day/sunset/night/overcast), gravity (-9.8), follow (boolean)
Returns: Interactive 3D URL with orbit controls + inline PNG thumbnail for chat preview.
get_3d — Inspect 3D Scene
Retrieve the full element list of an existing 3D render by ID. Use this before base_render_id to see what a scene contains and plan modifications.
Input: render_id (the short alphanumeric ID from the URL)
Returns: All elements with their properties (shapes, positions, colors, materials).
create_show — Slideshow Presentations
Bundle multiple plot_graph results into a slideshow. Create each slide with plot_graph first, then pass the render IDs here.
Input: title (string), slide_ids (array of render IDs from plot_graph results), summary (optional per-slide text).
Returns: Interactive show URL with prev/next navigation, keyboard controls, and auto-play.
Example Prompts
- "Plot x³ - 3x + 1 and show me its roots and extrema" → Interactive graph with computed roots (x ≈ -1.88, 0.35, 1.53) and extrema
- "Build a village with a red house, trees, and a campfire" → 3D scene with Chinese-style house (red color triggers Chinese variant), PNG thumbnail in chat
- "Plot the surface z = sin(x) * cos(y)" → Interactive 3D surface plot with orbit controls
- "Create a 3-slide show: y=x², y=x²+2 shifted up, y=(x-3)² shifted right" → Slideshow URL with navigation
The Same Tools on the Web
Several MathTalking pages are the browser form of a call you can make here. If you are answering the same question an agent would, the tool call is usually faster than pointing someone at the page — and both compute with the same engine.
| Web page | Equivalent call |
|---|---|
| Quadratic Roots, Root Finder | analyze {type: "roots", f} |
| Function Intersection | analyze {type: "intersect", f, g} |
| Tangent Calculator | analyze {type: "tangent", f, x} |
| Area Between Curves | analyze {type: "area_between", f, g, a, b} |
| Arc Length | analyze {type: "arc_length", f, a, b} |
| Closest Point | analyze {type: "closest_point", f, px, py} |
| 3D Net Generator and the shape-net pages | net_generator {shape, dims} |
Add plot: true to an analyze call to get the same picture the page shows.
Statistics pages that need a dataset (histogram, regression, box plot, distribution fitting) have no tool call on purpose: sending raw rows through a model costs a token per data point. Point people at mathtalking.com/stat, where the data stays on their device.
When to Use
- User asks to graph, plot, or visualize any math
- You need to verify a mathematical result visually
- Geometry needs precise rendering (triangles, circles, constructions)
- 3D scenes — shapes, architecture, creative builds
- Multi-step explanations — create slides, bundle into shows
- You want a shareable URL the user can explore interactively
Why Use This (vs generating images)
- Computed, not hallucinated — roots from actual zero-crossings, not LLM guesses
- Interactive — zoom, pan, rotate (3D), adjust sliders
- Shareable — permanent URL for every result
- Token efficient — ~500 output tokens vs ~3,000-5,000 for generated code
- 9 languages — en, zh, zh-TW, ja, ko, es, fr, de, pt-BR
Quick Test
# 2D graph
curl -X POST https://mathtalking.com/api/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"plot_graph","arguments":{"elements":[{"type":"function","expression":"sin(x)","color":"#4A90D9"}]}}}'
# 3D scene
curl -X POST https://mathtalking.com/api/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"plot_3d","arguments":{"elements":[{"type":"mesh","shape":"sphere","r":1,"color":"#ff0000","position":[0,1,0]}]}}}'
Links
- Website: mathtalking.com
- 3D Builder: mathtalking.com/3d
- Privacy: mathtalking.com/privacy
- Discord: discord.gg/5auPsmxh
- X: @Mathtalking_com
MathTalking MCP questions
How do I add MathTalking MCP to Claude Code?
Run claude mcp add mathgraphs-mcp -- npx -y mathgraphs-mcp in your terminal. Add --scope user to make it available in every project.
How do I add MathTalking MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does MathTalking MCP provide?
It exposes 42 tools, including function, points, segment, label, triangle.
Do I need an account or API key to use this?
No, no account or API key is required to use the server.
How are mathematical results like roots and extrema calculated?
Results are graph-verified, meaning they are computed from the actual plotted curves rather than being generated by the AI model.
Can I create 3D scenes with animations and physics?
Yes, the 3D scene builder supports animations like spinning or orbiting, as well as physics parameters like velocity and mass.
What kind of output formats are supported for graphs?
The server supports interactive URLs, iframe embeds, and SVG vector images.