mathgraphs-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:

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 title
• summary — frosted glass overlay text on the graph
• gridStyle — "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 parameters
• theme — "default", "terminal", "wallstreet", "science", or "finance"
• base_render_id — build on an existing render instead of re-sending every element
• remove_indices — drop elements from the base render by index (see get_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:

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:

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:

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 (use get_3d to 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