@axiom-foundation/mcp
MCP server adapter for the Axiom Rule API.
Versions
0.1.4latest0.1.30.1.20.1.10.1.0Tools 23
get_capabilities Read API version, environment, endpoints, repository status, runtime packages, and sample calculation requests.
get_version Read the API version, environment, and deployment identity.
list_certified_nodes Page through the certified node ledger: every rule node the deployment certifies as servable.
get_node Read one certified rule node by legal id, with its certificate and ledger metadata.
list_corpus_subtrees List every rulespec subtree in the live corpus mirror that can be executed on demand via calculate_household with `root` — no pre-registered package required.
compose_graph Build the dependency graph for any encoded rule or file legal id by walking RuleSpec imports across the live corpus mirror.
get_subgraph Read the certified closure from up to 20 root node legal ids, in program-graph shape.
get_root_inputs Read the typed input catalog for any rulespec root (file legal id, optionally with #rule) before calling calculate_household with `root`.
list_runtime_artifacts List every compiled artifact this deployment pins: release tag, corpus sha, and file sha256, for pinning and replay.
list_programs List programs discoverable in the configured Axiom rule index, including those without an executable runtime package.
search_rules Search encoded and source-linked rules. Use jurisdiction/program filters when the user names a location or benefit program.
get_rule Read one rule by stable rule id or citation path, including summary, symbols, provenance, dependencies, and dependents.
get_rule_sources Read source and provenance references for one rule.
get_rule_dependencies Read upstream dependencies and downstream dependents for one rule.
list_runtime_packages List programs executable by the configured Axiom calculation runtime.
get_runtime_package Read executable package inputs, outputs, aliases, and sample request for a program.
list_parity_cases List canonical Axiom runtime parity cases, expected outputs, trace variables, notes, external comparison metadata, and calculation requests.
run_parity_cases Run canonical Axiom runtime parity cases and return variable-level differences, trace outputs, and calculation trace.
calculate_household Run a calculation. Address a registered package with program_id + jurisdiction (discover inputs with get_runtime_package), or run any corpus subtree on demand with root (discover inputs with get_root_inputs). The two modes are mutually exclusive.
calculate_household_compat PolicyEngine household-API compatible calculation: accepts the PE v1 household body for a country_id and mirrors PE's response envelope, with an `axiom` sidecar reporting which variables Axiom computed.
calculate_batch Run up to 25 calculations in one synchronous request. Results return positionally: results[i] corresponds to requests[i], each independently ok or error.
submit_calculation_job Submit up to 50 calculations as a detached async job. Returns a job id to poll with get_calculation_job; results are retained for 24 hours and visible only to the submitting API key.
get_calculation_job Read the status, progress, and results of a calculation job submitted with submit_calculation_job.
Permissions 2
shell high env_vars low