jacobian
Jacobian gives an agent a searchable, executable vocabulary of typed mathematical operations: find one, run it, and pass its typed result into the next operation.
Search by need —
math.findtakes an ordinary-languagequerydescribing the mathematical result required (object, constraints, scope, and whether you want a value, witness, certificate, obstruction, profile, or enumeration) and returns compact ranked matches.Control retrieval — optional
namespace(only when the primary operation-ID namespace is known),limit(1–20, default 10),search_mode(preciseapplicability filtering orbroadlexical recall), and opaquecursorto page through matches withnext_cursor.Inspect one exact contract — pass
operation_idtomath.findto get the authoritative input/output schemas, operator-authored schema-validexamples, read-only flag, tags, discovery terms, and declaredruntime_requirements.Check optional backends — inspection reports live availability of optional system runtimes (
singular,qepcad) as AVAILABLE, MISSING, UNSUPPORTED, or CHECK_FAILED in the server environment.Execute a bounded result —
math.runruns one installed operation by ID with a typed JSONpayloadand returns the canonical mathematicaloutputplusruntime_msin a transport envelope.Compose results — an operation's
outputis a typed value that a subsequently inspected operation can accept unchanged, so operations chain into solutions beyond any single one's design.Cover the built-in portfolio — polynomial maps and polynomial algebra, exact linear algebra, graphs/paths/colorings/isomorphism, bounded SAT and SMT solving via Z3, finite algebra, probability, geometry, and topology.
Trust the semantics — results are exact where claimed and make approximation, incompleteness, or uncertainty explicit; timeouts, incomplete searches, and missing witnesses appear only inside the domain result that owns them.
Get clear failures — malformed payloads, unknown operation IDs, and host failures surface as tool errors, with discovery errors discriminated by code (
INVALID_CURSOR,UNKNOWN_OPERATION) and stage.Stay local and side-effect-free — both tools are read-only, closed-world, and deterministic for retrieval; the full bulk catalog is available at
operation://catalogwhen genuinely needed.Use it outside MCP too — the same library is exposed through the CLI (
jacobian inspect,jacobian run --json) and a native Python API (jacobian.backends.check_backend).
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@jacobian find a counterexample to the claim that f(x)=x^2 is injective"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
English · 简体中文
Jacobian is an MCP server that gives AI agents a searchable vocabulary of typed
mathematical operations. math.find matches a mathematical need or inspects one
exact contract, and math.run executes it and returns its typed result. The same
mathematical library is also available through a CLI and native Python API.
Each operation establishes one stable, reusable mathematical postcondition rather than prescribing a workflow or proof strategy. Results are exact where claimed and make approximation, incompleteness, or uncertainty explicit.
Jacobian's hypothesis is that mathematical reasoning benefits from an executable vocabulary of semantically scoped, bounded operations. Rather than exposing large domain solvers or precomposed workflows, Jacobian exposes mathematical primitives that agents can search for and compose into solutions beyond what any individual operation was designed to solve. The library supplies trustworthy mathematical moves; the reasoning model decides which moves to make, how to combine their results, and when to stop. Keeping the operations semantically narrow and domain-owned preserves that search space instead of baking one proof strategy or workflow into the tools themselves.
See Executable mathematical vocabulary for what semantic atomicity means and how the operation vocabulary grows.
Quickstart
Set up Jacobian for your agents with a single command. The setup command
requires Node.js 20.17+, 22.13+, or 23.5+ and uvx on your PATH.
npx jacobian@latest setupChoose detected agents and review the changes before they are written. Setup
does not install Node.js, Python, uv, or an agent. For automation, preview
an explicit plan with npx jacobian@latest setup --codex --dry-run; use
--yes only with explicit agent flags or --all.
To refresh an existing registration explicitly, run
npx jacobian@latest upgrade and select the agents to update. The generated
launcher pins the exact release resolved by npm.
Run the canonical Python MCP command without installing Jacobian globally:
uvx --python 3.12 --from jacobian jacobian-mcpWhere an MCP host requires an npm command, the npm package is a deterministic carrier for that same command:
npx jacobian mcpFor a persistent installation:
python -m pip install jacobian
jacobian-mcpThat package includes Jacobian's exact maintained Python backend stack: SymPy, NetworkX, Z3, and Python-FLINT. A normal Python or npm installation therefore exposes the same built-in Python-backed operation portfolio. The tested binary-install contract is CPython 3.12 or 3.13 on glibc Linux x86-64; the release gate installs the built wheel and starts Jacobian on both Python versions. Other systems may have compatible upstream wheels, but are not part of the tested release contract yet. In particular, Alpine/musl cannot install the complete mandatory stack from PyPI.
Singular and QEPCAD are optional system runtimes for a small subset of operations.
The Python installation does not provision them, and ordinary operations do not
require Docker. Python callers can use jacobian.backends.check_backend; MCP
inspection reports availability in the server environment. See
backend requirements for exact coverage
and setup.
The Python distribution contains the mathematical kernel, CLI, and MCP server.
The npm package deterministically maps its exact package version to the
corresponding uvx invocation.
Related MCP server: math-logic-mcp
Compute one bounded result
An ordinary operation returns mathematics first. For example,
matrix.determinant.compute accepts one exact rational matrix and returns its
determinant directly. Callers compose results by passing their typed values to a
subsequent operation.
For a local terminal workflow, inspect the exact installed contract and run one of its examples with the CLI:
jacobian inspect integer.compute.extended_gcd
jacobian run integer.compute.extended_gcd --json '{"left":"84","right":"30"}'The second command returns the gcd and Bézout coefficients as JSON. In an MCP
host, use math.find in inspection mode to read the same contract and math.run
with the same payload shape. See Discover and invoke operations
for that agent workflow.
Available mathematics
The built-in portfolio covers work in:
polynomial maps and polynomial algebra;
exact linear algebra;
graphs, paths, colorings, and isomorphism;
bounded SAT and SMT solving;
finite algebra, probability, geometry, and topology.
SAT and SMT operations use the maintained Z3 Python binding directly. Use
math.find to match the mathematical result needed, then use its inspection
mode on a promising operation before calling math.run once.
See the domain operation library for the maintained operation portfolio and backend requirements.
Status
Jacobian 0.23.0 is pre-stable. Its published package and operation contracts describe the supported surface; experimental operation contracts may change between releases.
Documentation
Documentation home: tutorials, how-to guides, reference, and explanations
Architecture: runtime structure and trust boundaries
Product model: operation contracts, ownership, and project boundaries
Tool reference: MCP resources and invocation contracts
Backend requirements: maintained Python backends
Remote deployment: HTTP deployment and authentication
Contributing
Jacobian uses Python 3.12, uv, and a small Makefile:
make setup
make affected AFFECTED_BASE=origin/mainRead CONTRIBUTING.md before changing code. It documents focused test commands, verification rules, documentation placement, and pull-request expectations.
License
Available Tools
2 toolsmath.findSearch installed Jacobian math toolsARead-onlyIdempotent
Find or inspect public Jacobian MCP operations.
Forms:
query: describe one local mathematical need in ordinary language.namespace,limit,cursor, andsearch_modeare optional search controls. Preserve established mathematical names from the task, the supplied objects and constraints, the requested computation or decision, the full scalar, batch, or exhaustive scope, and whether the requested result is a value, witness, certificate, obstruction, profile, or complete enumeration. Do not replace a supplied named property only with its expanded definition, translate the need into catalog tags, or submit the surrounding proof goal.operation_id: pass one exact operation ID to receive its authoritative input and output schemas, operator-authored examples, and current optional backend availability. Matches expose staticruntime_requirements; inspection checks these runtimes in the server environment.
For matching, use namespace only when the primary operation-ID namespace is already
known with high confidence. Matching returns 10 candidates by default; request up to
20 when a wider first page is useful. Follow next_cursor with the same query, namespace, and search_mode
to continue; the limit may change. Ordered matches are deterministic retrieval candidates, not
applicability claims; inspect a promising operation before math.run. Read
operation://catalog only when the complete bulk catalog is genuinely needed.
An unknown operation ID returns kind: "error" with error.code: "UNKNOWN_OPERATION";
inspect kind even when MCP isError is false. Search with query to find an
installed operation, then inspect its exact ID. Zero matches is a successful search.
Examples:
{"query":"exact determinant of a rational matrix","namespace":"matrix","limit":3}{"operation_id":"polynomial.compute.gcd"}
Inputs: limit, query, cursor, namespace, +2 more. Returns: Closed discriminated output returned directly through MCP SDK 2.0.
math.runRun one installed Jacobian math toolARead-only
Run one installed math tool by ID with its typed payload. A successful call returns
the operation-owned canonical mathematical value in output; a later inspected
operation may accept that complete value unchanged. Read its fields to determine what
the calculation established. MCP reports malformed payloads, unknown IDs, and host
failures as tool errors, not as mathematical results. If the payload shape is unknown,
inspect the exact operation with math.find. When it publishes an examples item, copy
and adapt that item's input object as the payload; otherwise, form the payload from
the input schema and its field descriptions. Do not call math.run with an empty
payload merely to discover required fields; inspection is authoritative.
Timeout, incomplete search, and missing witnesses appear only in the concrete domain result that owns them; none is a mathematical conclusion by itself.
Examples:
{"operation_id":"integer.compute.extended_gcd","payload":{"left":"84","right":"30"}}
Inputs: payload (required), operation_id (required). Returns: The final transport envelope around one direct mathematical result.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
math.find is clearly for discovery and inspection of operations, while math.run is clearly for executing a chosen operation. Their purposes do not overlap and the descriptions consistently direct users to inspect before running.
Both tools follow the same math.<verb> pattern with lowercase snake_case verbs. The naming is predictable and consistent across the set.
Two tools are sufficient for a dispatcher-style math catalog: one to find/inspect operations and one to run them. It is slightly below the typical 3-15 range, but the minimal surface is justified by the server's purpose.
The set covers the core lifecycle: search, inspect schemas/examples, and execute an operation by ID. Minor gaps exist for batch execution, composition, or direct catalog listing, but these are workable through repeated calls.
Maintenance
Related MCP Connectors
Educational MCP server with 17 math/stats tools, visualizations, and persistent workspace
Math MCP server for primality, factorization, Java templates, and integer multiplication.
This MCP server enables users to perform scientific computations regarding linear algebra and vect…
Deterministic physics runtime with a proof on every answer: 61 models, open and keyless over MCP.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP server for step-by-step mathematical reasoning and planning, enabling AI agents to execute calculations and perform GUI actions like opening PowerPoint.1Apache 2.0
- AlicenseAqualityDmaintenanceMCP server that gives small LLMs verified symbolic-math & logic tools.62Apache 2.0
- AlicenseBqualityBmaintenanceMCP server for symbolic computation that enables AI agents to perform step-by-step derivations, transform formulas, and verify results with full provenance, combining natural language with formal mathematical operations.4113Apache 2.0
- AlicenseNot gradedqualityDmaintenanceAn MCP server for semantic search over 9.27 million mathematical statements from sources like arXiv and Stacks Project, offering 5 tools for filtered search, citation weighting, and dependency graph traversal.MIT