ai.geodesiclabs/governance-platform

Official37 toolsLive

by geodesiclabs

Pre-execution governance for AI agents. Deterministic PASS/FAIL/REVIEW verdicts, replayable proof.

The ai.geodesiclabs/governance-platform MCP server provides pre-execution governance for AI agents. It generates deterministic PASS/FAIL/REVIEW verdicts and includes replayable proof, enabling consistent evaluation of an agent’s actions before execution.

🛠️ Key Features

Pre-execution governance for AI agents
Deterministic PASS/FAIL/REVIEW verdicts
Replayable proof
Exposes 37 tools

🚀 Use Cases

Governing agent behavior before execution
Enforcing consistent decisioning with deterministic outcomes
Auditing or replaying governance evaluations via proof

⚡ Developer Benefits

Deterministic verdicts for repeatable governance logic
Replayable proof to support verification of pre-execution checks

⚠️ Limitations

Limited information available beyond governance scope, verdict types, replayable proof, and tool count

Captured live from the server via tools/list.

validate

Validate structured data against a Blueprint's rules BEFORE the result is used. Returns PASS, FAIL, or REVIEW with plain-language findings, repair suggestions, a determinism hash, and a re-verifiable certificate. Same input + same rules = same verdict, every time.

Parameters3

api_key	string	required	GeodesicAI API key (gai_...)
structured_data	object	required	The document's extracted fields as key/value pairs. Keys are open by design - your Blueprint's rules define what is checked
blueprint	string	optional	Blueprint name (workflow_name) to use

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "GeodesicAI API key (gai_...)",
      "title": "Api Key",
      "type": "string"
    },
    "structured_data": {
      "additionalProperties": true,
      "description": "The document's extracted fields as key/value pairs. Keys are open by design - your Blueprint's rules define what is checked",
      "title": "Structured Data",
      "type": "object"
    },
    "blueprint": {
      "default": "default",
      "description": "Blueprint name (workflow_name) to use",
      "title": "Blueprint",
      "type": "string"
    }
  },
  "required": [
    "api_key",
    "structured_data"
  ],
  "title": "validateArguments"
}

validate_repair

Validate structured data against a Blueprint and, when it fails, include repair suggestions (corrected values with the rule each fix is based on) in the same call. Same verdicts as validate: PASS, FAIL, or REVIEW, with reasons and proof.

Parameters3

api_key	string	required	GeodesicAI API key (gai_...)
structured_data	object	required	The document's extracted fields as key/value pairs. Keys are open by design - your Blueprint's rules define what is checked
blueprint	string	optional	Blueprint name (workflow_name) to use

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "GeodesicAI API key (gai_...)",
      "title": "Api Key",
      "type": "string"
    },
    "structured_data": {
      "additionalProperties": true,
      "description": "The document's extracted fields as key/value pairs. Keys are open by design - your Blueprint's rules define what is checked",
      "title": "Structured Data",
      "type": "object"
    },
    "blueprint": {
      "default": "default",
      "description": "Blueprint name (workflow_name) to use",
      "title": "Blueprint",
      "type": "string"
    }
  },
  "required": [
    "api_key",
    "structured_data"
  ],
  "title": "validate_repairArguments"
}

create_blueprint

Create a Blueprint - the governance contract validation runs against. A Blueprint defines what correct means for your data: fields, the math that must hold between them, and acceptable ranges. Start from load_rule_pack or discover_patterns if you have no rules yet; invoke the blueprint_guide prompt for the full rule/constraint reference. Returns the new Blueprint's API key.

Parameters16

api_key	string	required	GeodesicAI API key (gai_...)
customer_name	string	required	Organization or project name (also used for storage folder naming)
workflow_name	string	required	Unique Blueprint identifier; the value passed as 'blueprint' in validate
mode	string	optional	observe: platform checks the agent's work; enforce: platform computes derived fields itself
extracted_fields	array	optional	Field names the agent extracts from source data, e.g. ['vendor','qty','unit_cost']
derived_fields	array	optional	Field names the platform computes from other fields, e.g. ['subtotal','total']
derivation_rules	array	optional	Math rules as objects. Types: add, subtract, multiply, divide, round, copy, sum (multi-operand), items_multiply, items_sum. Each needs 'type' plus its fields; see the blueprint_guide prompt
formal_constraints	array	optional	Constraint objects. Types incl. magnitude_anchor {field,min,max}, relative_anchor {field,reference_field,ratio_min,ratio_max}, max_action_threshold {field,threshold,on_violation}, required_fields {fields}, equals, range, in_set, regex_match, items_magnitude_anchor; see the blueprint_guide prompt
semantic_checks	array	optional	Domain-specific semantic check objects
require_math	boolean	optional	Validate mathematical relationships
require_consistency	boolean	optional	Check internal field consistency
require_coherence	boolean	optional	Check cross-field plausibility
require_provenance	boolean	optional	Require extraction source locations for fields
require_high_assurance	boolean	optional	Strictest mode: every check must pass
enable_anomaly_detection	boolean	optional	Flag records that break no rules but do not fit the reference pattern
enable_drift_tracking	boolean	optional	Track pattern stability across batches

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "GeodesicAI API key (gai_...)",
      "title": "Api Key",
      "type": "string"
    },
    "customer_name": {
      "description": "Organization or project name (also used for storage folder naming)",
      "title": "Customer Name",
      "type": "string"
    },
    "workflow_name": {
      "description": "Unique Blueprint identifier; the value passed as 'blueprint' in validate",
      "title": "Workflow Name",
      "type": "string"
    },
    "mode": {
      "default": "observe",
      "description": "observe: platform checks the agent's work; enforce: platform computes derived fields itself",
      "enum": [
        "observe",
        "enforce"
      ],
      "title": "Mode",
      "type": "string"
    },
    "extracted_fields": {
      "default": null,
      "description": "Field names the agent extracts from source data, e.g. ['vendor','qty','unit_cost']",
      "items": {},
      "title": "Extracted Fields",
      "type": "array"
    },
    "derived_fields": {
      "default": null,
      "description": "Field names the platform computes from other fields, e.g. ['subtotal','total']",
      "items": {},
      "title": "Derived Fields",
      "type": "array"
    },
    "derivation_rules": {
      "default": null,
      "description": "Math rules as objects. Types: add, subtract, multiply, divide, round, copy, sum (multi-operand), items_multiply, items_sum. Each needs 'type' plus its fields; see the blueprint_guide prompt",
      "items": {},
      "title": "Derivation Rules",
      "type": "array"
    },
    "formal_constraints": {
      "default": null,
      "description": "Constraint objects. Types incl. magnitude_anchor {field,min,max}, relative_anchor {field,reference_field,ratio_min,ratio_max}, max_action_threshold {field,threshold,on_violation}, required_fields {fields}, equals, range, in_set, regex_match, items_magnitude_anchor; see the blueprint_guide prompt",
      "items": {},
      "title": "Formal Constraints",
      "type": "array"
    },
    "semantic_checks": {
      "default": null,
      "description": "Domain-specific semantic check objects",
      "items": {},
      "title": "Semantic Checks",
      "type": "array"
    },
    "require_math": {
      "default": true,
      "description": "Validate mathematical relationships",
      "title": "Require Math",
      "type": "boolean"
    },
    "require_consistency": {
      "default": true,
      "description": "Check internal field consistency",
      "title": "Require Consistency",
      "type": "boolean"
    },
    "require_coherence": {
      "default": true,
      "description": "Check cross-field plausibility",
      "title": "Require Coherence",
      "type": "boolean"
    },
    "require_provenance": {
      "default": false,
      "description": "Require extraction source locations for fields",
      "title": "Require Provenance",
      "type": "boolean"
    },
    "require_high_assurance": {
      "default": false,
      "description": "Strictest mode: every check must pass",
      "title": "Require High Assurance",
      "type": "boolean"
    },
    "enable_anomaly_detection": {
      "default": false,
      "description": "Flag records that break no rules but do not fit the reference pattern",
      "title": "Enable Anomaly Detection",
      "type": "boolean"
    },
    "enable_drift_tracking": {
      "default": false,
      "description": "Track pattern stability across batches",
      "title": "Enable Drift Tracking",
      "type": "boolean"
    }
  },
  "required": [
    "api_key",
    "customer_name",
    "workflow_name"
  ],
  "title": "create_blueprintArguments"
}

list_blueprints

List the Blueprints on this account with field/rule/constraint counts and mode. Use the returned workflow_name as 'blueprint' in validate.

Parameters1

api_key

string

required

GeodesicAI API key (gai_...)

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "GeodesicAI API key (gai_...)",
      "title": "Api Key",
      "type": "string"
    }
  },
  "required": [
    "api_key"
  ],
  "title": "list_blueprintsArguments"
}

repair

One-shot repair: return corrected values that would make failing data valid under the Blueprint. Use repair_path to see the steps instead.

Parameters5

api_key	string	required	GeodesicAI API key (gai_...)
structured_data	object	required	The document's extracted fields as key/value pairs. Keys are open by design - your Blueprint's rules define what is checked
derivation_rules	array	optional	Math rules as objects. Types: add, subtract, multiply, divide, round, copy, sum (multi-operand), items_multiply, items_sum. Each needs 'type' plus its fields; see the blueprint_guide prompt
formal_constraints	array	optional	Constraint objects. Types incl. magnitude_anchor {field,min,max}, relative_anchor {field,reference_field,ratio_min,ratio_max}, max_action_threshold {field,threshold,on_violation}, required_fields {fields}, equals, range, in_set, regex_match, items_magnitude_anchor; see the blueprint_guide prompt
blueprint	string	optional	Blueprint name (workflow_name) to use

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "GeodesicAI API key (gai_...)",
      "title": "Api Key",
      "type": "string"
    },
    "structured_data": {
      "additionalProperties": true,
      "description": "The document's extracted fields as key/value pairs. Keys are open by design - your Blueprint's rules define what is checked",
      "title": "Structured Data",
      "type": "object"
    },
    "derivation_rules": {
      "default": null,
      "description": "Math rules as objects. Types: add, subtract, multiply, divide, round, copy, sum (multi-operand), items_multiply, items_sum. Each needs 'type' plus its fields; see the blueprint_guide prompt",
      "items": {},
      "title": "Derivation Rules",
      "type": "array"
    },
    "formal_constraints": {
      "default": null,
      "description": "Constraint objects. Types incl. magnitude_anchor {field,min,max}, relative_anchor {field,reference_field,ratio_min,ratio_max}, max_action_threshold {field,threshold,on_violation}, required_fields {fields}, equals, range, in_set, regex_match, items_magnitude_anchor; see the blueprint_guide prompt",
      "items": {},
      "title": "Formal Constraints",
      "type": "array"
    },
    "blueprint": {
      "default": null,
      "description": "Blueprint name (workflow_name) to use",
      "title": "Blueprint",
      "type": "string"
    }
  },
  "required": [
    "api_key",
    "structured_data"
  ],
  "title": "repairArguments"
}

check_blueprint_health

Static pre-deploy analysis of a Blueprint's rule set. Returns a health verdict - healthy, acceptable, fragile, rigid, split, brittle_islands, or unsatisfiable - with advice, including joint conflicts pairwise checks miss.

Parameters3

api_key	string	required	GeodesicAI API key (gai_...)
blueprint	string	optional	Blueprint name (workflow_name) to use
config	object	optional	Raw blueprint config with derivation_rules and formal_constraints (used when 'blueprint' is not given)

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "GeodesicAI API key (gai_...)",
      "title": "Api Key",
      "type": "string"
    },
    "blueprint": {
      "default": "",
      "description": "Blueprint name (workflow_name) to use",
      "title": "Blueprint",
      "type": "string"
    },
    "config": {
      "additionalProperties": true,
      "default": null,
      "description": "Raw blueprint config with derivation_rules and formal_constraints (used when 'blueprint' is not given)",
      "title": "Config",
      "type": "object"
    }
  },
  "required": [
    "api_key"
  ],
  "title": "check_blueprint_healthArguments"
}

compare_semantic_equivalence

Compare two payloads under the dual-hash design: content_hash is invariant to field order and numeric formatting (5 vs '5.00'); semantic_hash additionally to field renaming. Verdicts: identical_content, same_structure_and_values_renamed_vocabulary, or semantically_different.

Parameters3

api_key	string	required	GeodesicAI API key (gai_...)
payload_a	object	required	First structured payload (arbitrary JSON object)
payload_b	object	required	Second structured payload to compare against payload_a

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "GeodesicAI API key (gai_...)",
      "title": "Api Key",
      "type": "string"
    },
    "payload_a": {
      "additionalProperties": true,
      "description": "First structured payload (arbitrary JSON object)",
      "title": "Payload A",
      "type": "object"
    },
    "payload_b": {
      "additionalProperties": true,
      "description": "Second structured payload to compare against payload_a",
      "title": "Payload B",
      "type": "object"
    }
  },
  "required": [
    "api_key",
    "payload_a",
    "payload_b"
  ],
  "title": "compare_semantic_equivalenceArguments"
}

govern_inference

Quality-govern an in-progress AI generation step BEFORE its output is used (complements validate, which checks finished documents). Returns an action - STOP, CONTINUE, REPAIR_REGION, REUSE_MOTIF, REVIEW, ESCALATE - with a plain-language explanation. Durably recorded; retrieve later with get_inference_trace.

Parameters7

api_key	string	required	GeodesicAI API key (gai_...)
task_type	string	required	Kind of generation step being governed
payload	object	required	Task-type payload: generative_text {text,...}; retrieval {query,candidates}; generic {features}
inference_id	string	required	Caller-chosen ID grouping the steps of one generation
constraints	object	optional	Optional governance constraint config object
source	string	optional	Free-form caller label recorded for audit
step_index	integer	optional	Step number within this generation (0-based)

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "GeodesicAI API key (gai_...)",
      "title": "Api Key",
      "type": "string"
    },
    "task_type": {
      "description": "Kind of generation step being governed",
      "enum": [
        "generative_text",
        "retrieval",
        "generic"
      ],
      "title": "Task Type",
      "type": "string"
    },
    "payload": {
      "additionalProperties": true,
      "description": "Task-type payload: generative_text {text,...}; retrieval {query,candidates}; generic {features}",
      "title": "Payload",
      "type": "object"
    },
    "inference_id": {
      "description": "Caller-chosen ID grouping the steps of one generation",
      "title": "Inference Id",
      "type": "string"
    },
    "constraints": {
      "additionalProperties": true,
      "default": null,
      "description": "Optional governance constraint config object",
      "title": "Constraints",
      "type": "object"
    },
    "source": {
      "default": "mcp",
      "description": "Free-form caller label recorded for audit",
      "title": "Source",
      "type": "string"
    },
    "step_index": {
      "default": 0,
      "description": "Step number within this generation (0-based)",
      "title": "Step Index",
      "type": "integer"
    }
  },
  "required": [
    "api_key",
    "task_type",
    "payload",
    "inference_id"
  ],
  "title": "govern_inferenceArguments"
}

get_inference_trace

Retrieve the durable audit trail for a governed generation: every recorded decision and its reasons.

Parameters2

api_key	string	required	GeodesicAI API key (gai_...)
inference_id	string	required	Caller-chosen ID grouping the steps of one generation

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "GeodesicAI API key (gai_...)",
      "title": "Api Key",
      "type": "string"
    },
    "inference_id": {
      "description": "Caller-chosen ID grouping the steps of one generation",
      "title": "Inference Id",
      "type": "string"
    }
  },
  "required": [
    "api_key",
    "inference_id"
  ],
  "title": "get_inference_traceArguments"
}

recent_inference_decisions

Recent generation-governance decisions across all runs - what was approved, held, and escalated.

Parameters3

api_key	string	required	GeodesicAI API key (gai_...)
limit	integer	optional	Maximum rows to return
action	string	optional	Optional action filter (STOP, CONTINUE, REVIEW, ...)

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "GeodesicAI API key (gai_...)",
      "title": "Api Key",
      "type": "string"
    },
    "limit": {
      "default": 25,
      "description": "Maximum rows to return",
      "title": "Limit",
      "type": "integer"
    },
    "action": {
      "default": "",
      "description": "Optional action filter (STOP, CONTINUE, REVIEW, ...)",
      "title": "Action",
      "type": "string"
    }
  },
  "required": [
    "api_key"
  ],
  "title": "recent_inference_decisionsArguments"
}

verify_certificate

Independently re-verify a validation certificate. Integrity mode checks the hash chain; full mode (certificate + original data) recomputes every attested rule from scratch - trust nothing, recheck everything.

Parameters4

api_key	string	required	GeodesicAI API key (gai_...)
certificate	object	required	The certificate object from a prior validation response
data	object	optional	Original payload for full re-verification; omit for integrity-only mode
derivation_rules	array	optional	Rule list for independent attestation recomputation (optional)

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "GeodesicAI API key (gai_...)",
      "title": "Api Key",
      "type": "string"
    },
    "certificate": {
      "additionalProperties": true,
      "description": "The certificate object from a prior validation response",
      "title": "Certificate",
      "type": "object"
    },
    "data": {
      "additionalProperties": true,
      "default": null,
      "description": "Original payload for full re-verification; omit for integrity-only mode",
      "title": "Data",
      "type": "object"
    },
    "derivation_rules": {
      "default": null,
      "description": "Rule list for independent attestation recomputation (optional)",
      "items": {},
      "title": "Derivation Rules",
      "type": "array"
    }
  },
  "required": [
    "api_key",
    "certificate"
  ],
  "title": "verify_certificateArguments"
}

profile_blueprint_robustness

Sweep the Blueprint's numeric constraint bounds and report verdict stability: the stable band, the scales where the verdict first flips, and advice. Use before deploying bound changes.

Parameters3

api_key	string	required	GeodesicAI API key (gai_...)
blueprint	string	optional	Blueprint name (workflow_name) to use
config	object	optional	Raw blueprint config to profile (used when 'blueprint' is not given)

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "GeodesicAI API key (gai_...)",
      "title": "Api Key",
      "type": "string"
    },
    "blueprint": {
      "default": "",
      "description": "Blueprint name (workflow_name) to use",
      "title": "Blueprint",
      "type": "string"
    },
    "config": {
      "additionalProperties": true,
      "default": null,
      "description": "Raw blueprint config to profile (used when 'blueprint' is not given)",
      "title": "Config",
      "type": "object"
    }
  },
  "required": [
    "api_key"
  ],
  "title": "profile_blueprint_robustnessArguments"
}

forecast

Deterministic forward reasoning: from the current data state, generate and rank the valid next states reachable under the Blueprint's rules.

Parameters6

api_key	string	required	GeodesicAI API key (gai_...)
structured_data	object	required	The document's extracted fields as key/value pairs. Keys are open by design - your Blueprint's rules define what is checked
blueprint	string	optional	Blueprint name (workflow_name) to use
max_depth	integer	optional	Search depth, 1-10
max_branches	integer	optional	Branches per step, 1-10
rank_by	string	optional	Ranking criterion for returned paths

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "GeodesicAI API key (gai_...)",
      "title": "Api Key",
      "type": "string"
    },
    "structured_data": {
      "additionalProperties": true,
      "description": "The document's extracted fields as key/value pairs. Keys are open by design - your Blueprint's rules define what is checked",
      "title": "Structured Data",
      "type": "object"
    },
    "blueprint": {
      "default": "default",
      "description": "Blueprint name (workflow_name) to use",
      "title": "Blueprint",
      "type": "string"
    },
    "max_depth": {
      "default": 3,
      "description": "Search depth, 1-10",
      "title": "Max Depth",
      "type": "integer"
    },
    "max_branches": {
      "default": 5,
      "description": "Branches per step, 1-10",
      "title": "Max Branches",
      "type": "integer"
    },
    "rank_by": {
      "default": "drift",
      "description": "Ranking criterion for returned paths",
      "enum": [
        "drift",
        "confidence",
        "shortest",
        "risk"
      ],
      "title": "Rank By",
      "type": "string"
    }
  },
  "required": [
    "api_key",
    "structured_data"
  ],
  "title": "forecastArguments"
}

discover_patterns

Learn candidate validation rules and structural document types from a batch of your records, deterministically - no Blueprint required. Promote results with approve_rule. Source data is not stored.

Parameters3

api_key	string	required	GeodesicAI API key (gai_...)
documents	array	required	List of structured records (objects) to analyze
blueprint	string	optional	Blueprint name (workflow_name) to use

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "GeodesicAI API key (gai_...)",
      "title": "Api Key",
      "type": "string"
    },
    "documents": {
      "description": "List of structured records (objects) to analyze",
      "items": {},
      "title": "Documents",
      "type": "array"
    },
    "blueprint": {
      "default": "default",
      "description": "Blueprint name (workflow_name) to use",
      "title": "Blueprint",
      "type": "string"
    }
  },
  "required": [
    "api_key",
    "documents"
  ],
  "title": "discover_patternsArguments"
}

repair_path

Find the shortest sequence of field changes taking invalid data to a valid state, as an ordered path of intermediate states. Different from repair (one-shot nearest fix): use repair_path to explain or audit the fix, or compare alternative repairs.

Parameters5

api_key	string	required	GeodesicAI API key (gai_...)
structured_data	object	required	The document's extracted fields as key/value pairs. Keys are open by design - your Blueprint's rules define what is checked
blueprint	string	optional	Blueprint name (workflow_name) to use
max_depth	integer	optional	Search depth, 1-10
rank_by	string	optional	Ranking criterion for returned paths

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "GeodesicAI API key (gai_...)",
      "title": "Api Key",
      "type": "string"
    },
    "structured_data": {
      "additionalProperties": true,
      "description": "The document's extracted fields as key/value pairs. Keys are open by design - your Blueprint's rules define what is checked",
      "title": "Structured Data",
      "type": "object"
    },
    "blueprint": {
      "default": "default",
      "description": "Blueprint name (workflow_name) to use",
      "title": "Blueprint",
      "type": "string"
    },
    "max_depth": {
      "default": 4,
      "description": "Search depth, 1-10",
      "title": "Max Depth",
      "type": "integer"
    },
    "rank_by": {
      "default": "shortest",
      "description": "Ranking criterion for returned paths",
      "enum": [
        "shortest",
        "drift",
        "confidence",
        "risk"
      ],
      "title": "Rank By",
      "type": "string"
    }
  },
  "required": [
    "api_key",
    "structured_data"
  ],
  "title": "repair_pathArguments"
}

counterfactual

Run the same data under two rule sets and compare which future states remain valid - what-if analysis for rule changes.

Parameters5

api_key	string	required	GeodesicAI API key (gai_...)
structured_data	object	required	The document's extracted fields as key/value pairs. Keys are open by design - your Blueprint's rules define what is checked
blueprint	string	optional	Blueprint name (workflow_name) to use
rules_b	array	optional	Alternative derivation rules (rule set B)
constraints_b	array	optional	Alternative constraints (rule set B)

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "GeodesicAI API key (gai_...)",
      "title": "Api Key",
      "type": "string"
    },
    "structured_data": {
      "additionalProperties": true,
      "description": "The document's extracted fields as key/value pairs. Keys are open by design - your Blueprint's rules define what is checked",
      "title": "Structured Data",
      "type": "object"
    },
    "blueprint": {
      "default": "default",
      "description": "Blueprint name (workflow_name) to use",
      "title": "Blueprint",
      "type": "string"
    },
    "rules_b": {
      "default": null,
      "description": "Alternative derivation rules (rule set B)",
      "items": {},
      "title": "Rules B",
      "type": "array"
    },
    "constraints_b": {
      "default": null,
      "description": "Alternative constraints (rule set B)",
      "items": {},
      "title": "Constraints B",
      "type": "array"
    }
  },
  "required": [
    "api_key",
    "structured_data"
  ],
  "title": "counterfactualArguments"
}

analyze_anomaly

Explain whether a record fits the usual pattern for records like it, and which fields stand out. No Blueprint required.

Parameters2

api_key	string	required	GeodesicAI API key (gai_...)
structured_data	object	required	The document's extracted fields as key/value pairs. Keys are open by design - your Blueprint's rules define what is checked

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "GeodesicAI API key (gai_...)",
      "title": "Api Key",
      "type": "string"
    },
    "structured_data": {
      "additionalProperties": true,
      "description": "The document's extracted fields as key/value pairs. Keys are open by design - your Blueprint's rules define what is checked",
      "title": "Structured Data",
      "type": "object"
    }
  },
  "required": [
    "api_key",
    "structured_data"
  ],
  "title": "analyze_anomalyArguments"
}

create_chain

Create a multi-agent sequential chain: stages validate in order against one Blueprint, repairs propagate forward, TTL bounds the run. Siblings: submit_chain_stage advances the chain; handoff_audit verifies a transition between stages. Returns chain_id.

Parameters4

api_key	string	required	GeodesicAI API key (gai_...)
blueprint	string	required	Blueprint governing all stages of the chain
stages	array	required	Stage definitions, e.g. [{'stage_name':'extract','agent_name':'PDF Agent'}]; minimum 2
ttl	integer	optional	Chain timeout in seconds; stages cannot advance after expiry

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "GeodesicAI API key (gai_...)",
      "title": "Api Key",
      "type": "string"
    },
    "blueprint": {
      "description": "Blueprint governing all stages of the chain",
      "title": "Blueprint",
      "type": "string"
    },
    "stages": {
      "description": "Stage definitions, e.g. [{'stage_name':'extract','agent_name':'PDF Agent'}]; minimum 2",
      "items": {},
      "title": "Stages",
      "type": "array"
    },
    "ttl": {
      "default": 3600,
      "description": "Chain timeout in seconds; stages cannot advance after expiry",
      "title": "Ttl",
      "type": "integer"
    }
  },
  "required": [
    "api_key",
    "blueprint",
    "stages"
  ],
  "title": "create_chainArguments"
}

submit_chain_stage

Submit data for the chain's current stage; the platform validates it and advances the chain if it passes. Response includes next-stage info and accumulated repairs.

Parameters4

api_key	string	required	GeodesicAI API key (gai_...)
chain_id	string	required	Chain identifier returned by create_chain
stage	string	required	Stage name to submit for (must be the chain's current stage)
structured_data	object	required	The document's extracted fields as key/value pairs. Keys are open by design - your Blueprint's rules define what is checked

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "GeodesicAI API key (gai_...)",
      "title": "Api Key",
      "type": "string"
    },
    "chain_id": {
      "description": "Chain identifier returned by create_chain",
      "title": "Chain Id",
      "type": "string"
    },
    "stage": {
      "description": "Stage name to submit for (must be the chain's current stage)",
      "title": "Stage",
      "type": "string"
    },
    "structured_data": {
      "additionalProperties": true,
      "description": "The document's extracted fields as key/value pairs. Keys are open by design - your Blueprint's rules define what is checked",
      "title": "Structured Data",
      "type": "object"
    }
  },
  "required": [
    "api_key",
    "chain_id",
    "stage",
    "structured_data"
  ],
  "title": "submit_chain_stageArguments"
}

handoff_audit

Audit a handoff between two chain stages: a context capsule of verified facts from the prior stage, and (if proposed_data is given) a compatibility verdict that catches fields mutated in transit. Siblings: create_chain, submit_chain_stage.

Parameters5

api_key	string	required	GeodesicAI API key (gai_...)
chain_id	string	required	Chain identifier returned by create_chain
from_stage	string	required	Completed stage name (agent A)
to_stage	string	required	Stage about to start (agent B)
proposed_data	object	optional	Data agent B intends to submit; checked for mutation against agent A's verified fields

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "GeodesicAI API key (gai_...)",
      "title": "Api Key",
      "type": "string"
    },
    "chain_id": {
      "description": "Chain identifier returned by create_chain",
      "title": "Chain Id",
      "type": "string"
    },
    "from_stage": {
      "description": "Completed stage name (agent A)",
      "title": "From Stage",
      "type": "string"
    },
    "to_stage": {
      "description": "Stage about to start (agent B)",
      "title": "To Stage",
      "type": "string"
    },
    "proposed_data": {
      "additionalProperties": true,
      "default": null,
      "description": "Data agent B intends to submit; checked for mutation against agent A's verified fields",
      "title": "Proposed Data",
      "type": "object"
    }
  },
  "required": [
    "api_key",
    "chain_id",
    "from_stage",
    "to_stage"
  ],
  "title": "handoff_auditArguments"
}

approve_rule

Promote a rule discovered by discover_patterns into Blueprint-ready form.

Parameters3

api_key	string	required	GeodesicAI API key (gai_...)
rule_id	string	required	Discovered rule ID from discover_patterns
blueprint	string	optional	Blueprint name (workflow_name) to use

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "GeodesicAI API key (gai_...)",
      "title": "Api Key",
      "type": "string"
    },
    "rule_id": {
      "description": "Discovered rule ID from discover_patterns",
      "title": "Rule Id",
      "type": "string"
    },
    "blueprint": {
      "default": "default",
      "description": "Blueprint name (workflow_name) to use",
      "title": "Blueprint",
      "type": "string"
    }
  },
  "required": [
    "api_key",
    "rule_id"
  ],
  "title": "approve_ruleArguments"
}

reject_rule

Reject a discovered candidate rule so it will not be promoted into a Blueprint. Pair with approve_rule after discover_patterns.

Parameters3

api_key	string	required	GeodesicAI API key (gai_...)
rule_id	string	required	Discovered rule ID from discover_patterns
blueprint	string	optional	Blueprint name (workflow_name) to use

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "GeodesicAI API key (gai_...)",
      "title": "Api Key",
      "type": "string"
    },
    "rule_id": {
      "description": "Discovered rule ID from discover_patterns",
      "title": "Rule Id",
      "type": "string"
    },
    "blueprint": {
      "default": "default",
      "description": "Blueprint name (workflow_name) to use",
      "title": "Blueprint",
      "type": "string"
    }
  },
  "required": [
    "api_key",
    "rule_id"
  ],
  "title": "reject_ruleArguments"
}

structural_types

Retrieve the document categories a discover_patterns session identified (counts, distinguishing fields, domain hints). Read-only; returns status=no_session if discovery has not run for this namespace.

Parameters2

api_key	string	required	GeodesicAI API key (gai_...)
blueprint	string	optional	Blueprint name (workflow_name) to use

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "GeodesicAI API key (gai_...)",
      "title": "Api Key",
      "type": "string"
    },
    "blueprint": {
      "default": "default",
      "description": "Blueprint name (workflow_name) to use",
      "title": "Blueprint",
      "type": "string"
    }
  },
  "required": [
    "api_key"
  ],
  "title": "structural_typesArguments"
}

decompose_failure

Split the error between original and corrected values into direct rule violations, boundary violations, and systemic structural error, with per-field contributions. Use with a known-correct version to diff against; use analyze_anomaly when you only have the suspicious payload. Diagnostics-tier tool.

Parameters6

api_key	string	required	GeodesicAI API key (gai_...)
original_values	object	required	Original numeric field values as {field: number}
corrected_values	object	required	Corrected/expected numeric field values as {field: number}
derivation_rules	array	optional	Math rules as objects. Types: add, subtract, multiply, divide, round, copy, sum (multi-operand), items_multiply, items_sum. Each needs 'type' plus its fields; see the blueprint_guide prompt
formal_constraints	array	optional	Constraint objects. Types incl. magnitude_anchor {field,min,max}, relative_anchor {field,reference_field,ratio_min,ratio_max}, max_action_threshold {field,threshold,on_violation}, required_fields {fields}, equals, range, in_set, regex_match, items_magnitude_anchor; see the blueprint_guide prompt
blueprint	string	optional	Load rules from this Blueprint instead of passing them inline

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "GeodesicAI API key (gai_...)",
      "title": "Api Key",
      "type": "string"
    },
    "original_values": {
      "additionalProperties": true,
      "description": "Original numeric field values as {field: number}",
      "title": "Original Values",
      "type": "object"
    },
    "corrected_values": {
      "additionalProperties": true,
      "description": "Corrected/expected numeric field values as {field: number}",
      "title": "Corrected Values",
      "type": "object"
    },
    "derivation_rules": {
      "default": null,
      "description": "Math rules as objects. Types: add, subtract, multiply, divide, round, copy, sum (multi-operand), items_multiply, items_sum. Each needs 'type' plus its fields; see the blueprint_guide prompt",
      "items": {},
      "title": "Derivation Rules",
      "type": "array"
    },
    "formal_constraints": {
      "default": null,
      "description": "Constraint objects. Types incl. magnitude_anchor {field,min,max}, relative_anchor {field,reference_field,ratio_min,ratio_max}, max_action_threshold {field,threshold,on_violation}, required_fields {fields}, equals, range, in_set, regex_match, items_magnitude_anchor; see the blueprint_guide prompt",
      "items": {},
      "title": "Formal Constraints",
      "type": "array"
    },
    "blueprint": {
      "default": null,
      "description": "Load rules from this Blueprint instead of passing them inline",
      "title": "Blueprint",
      "type": "string"
    }
  },
  "required": [
    "api_key",
    "original_values",
    "corrected_values"
  ],
  "title": "decompose_failureArguments"
}

geometric_confidence

Summarize an already-computed state_vector into a confidence level (high/medium/low) with a recommendation. Post-hoc digest - use analyze_anomaly or check_drift for fresh analysis of raw data.

Parameters2

api_key	string	required	GeodesicAI API key (gai_...)
state_vector	object	required	state_vector object from a prior validate or get_execution_trace result

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "GeodesicAI API key (gai_...)",
      "title": "Api Key",
      "type": "string"
    },
    "state_vector": {
      "additionalProperties": true,
      "description": "state_vector object from a prior validate or get_execution_trace result",
      "title": "State Vector",
      "type": "object"
    }
  },
  "required": [
    "api_key",
    "state_vector"
  ],
  "title": "geometric_confidenceArguments"
}

check_realization

Structural realization analysis of a payload against the Blueprint's reference configuration (requires a 'realization' block; otherwise status=skipped). Diagnostics-tier tool; prefer validate or analyze_anomaly for standard checks.

Parameters3

api_key	string	required	GeodesicAI API key (gai_...)
structured_data	object	required	The document's extracted fields as key/value pairs. Keys are open by design - your Blueprint's rules define what is checked
blueprint	string	optional	Blueprint name (workflow_name) to use

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "GeodesicAI API key (gai_...)",
      "title": "Api Key",
      "type": "string"
    },
    "structured_data": {
      "additionalProperties": true,
      "description": "The document's extracted fields as key/value pairs. Keys are open by design - your Blueprint's rules define what is checked",
      "title": "Structured Data",
      "type": "object"
    },
    "blueprint": {
      "default": "default",
      "description": "Blueprint name (workflow_name) to use",
      "title": "Blueprint",
      "type": "string"
    }
  },
  "required": [
    "api_key",
    "structured_data"
  ],
  "title": "check_realizationArguments"
}

check_drift

Check whether recent submissions still match the established pattern for this Blueprint. Returns a stability verdict and observation count.

Parameters3

api_key	string	required	GeodesicAI API key (gai_...)
structured_data	object	required	The document's extracted fields as key/value pairs. Keys are open by design - your Blueprint's rules define what is checked
blueprint	string	optional	Blueprint name (workflow_name) to use

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "GeodesicAI API key (gai_...)",
      "title": "Api Key",
      "type": "string"
    },
    "structured_data": {
      "additionalProperties": true,
      "description": "The document's extracted fields as key/value pairs. Keys are open by design - your Blueprint's rules define what is checked",
      "title": "Structured Data",
      "type": "object"
    },
    "blueprint": {
      "default": "default",
      "description": "Blueprint name (workflow_name) to use",
      "title": "Blueprint",
      "type": "string"
    }
  },
  "required": [
    "api_key",
    "structured_data"
  ],
  "title": "check_driftArguments"
}

authorize_execution

Go/no-go for a real-world action (payment, filing, API write): runs full validation, then the Blueprint's execution gate. authorized=true only on PASS; REVIEW means do not proceed automatically. Different from validate: validate asks is this data correct, authorize_execution asks should this action happen.

Parameters3

api_key	string	required	GeodesicAI API key (gai_...)
structured_data	object	required	The document's extracted fields as key/value pairs. Keys are open by design - your Blueprint's rules define what is checked
blueprint	string	required	Blueprint name (workflow_name) to use

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "GeodesicAI API key (gai_...)",
      "title": "Api Key",
      "type": "string"
    },
    "structured_data": {
      "additionalProperties": true,
      "description": "The document's extracted fields as key/value pairs. Keys are open by design - your Blueprint's rules define what is checked",
      "title": "Structured Data",
      "type": "object"
    },
    "blueprint": {
      "description": "Blueprint name (workflow_name) to use",
      "title": "Blueprint",
      "type": "string"
    }
  },
  "required": [
    "api_key",
    "structured_data",
    "blueprint"
  ],
  "title": "authorize_executionArguments"
}

load_rule_pack

Load a prebuilt Blueprint template (invoices, timecards, legal, POs, claims). Call without pack_id to list packs; then create_blueprint to save a customized copy.

Parameters2

api_key	string	required	GeodesicAI API key (gai_...)
pack_id	string	optional	Rule pack ID; omit to list available packs

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "GeodesicAI API key (gai_...)",
      "title": "Api Key",
      "type": "string"
    },
    "pack_id": {
      "default": null,
      "description": "Rule pack ID; omit to list available packs",
      "title": "Pack Id",
      "type": "string"
    }
  },
  "required": [
    "api_key"
  ],
  "title": "load_rule_packArguments"
}

get_execution_trace

Run validation and return the per-node execution trace (node names, deterministic flags, timing) plus the verdict and determinism hash. Use validate for normal operation; this is for debugging and audit preparation.

Parameters3

api_key	string	required	GeodesicAI API key (gai_...)
structured_data	object	required	The document's extracted fields as key/value pairs. Keys are open by design - your Blueprint's rules define what is checked
blueprint	string	optional	Blueprint name (workflow_name) to use

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "GeodesicAI API key (gai_...)",
      "title": "Api Key",
      "type": "string"
    },
    "structured_data": {
      "additionalProperties": true,
      "description": "The document's extracted fields as key/value pairs. Keys are open by design - your Blueprint's rules define what is checked",
      "title": "Structured Data",
      "type": "object"
    },
    "blueprint": {
      "default": "default",
      "description": "Blueprint name (workflow_name) to use",
      "title": "Blueprint",
      "type": "string"
    }
  },
  "required": [
    "api_key",
    "structured_data"
  ],
  "title": "get_execution_traceArguments"
}

verify_replay

Verify two replay contracts represent the same deterministic execution: same input + same rules = same result, byte-identical. Mismatch fields localize the cause (data, rules, platform version, or trace). Use to prove a past decision reproduces today or that a migration changed nothing.

Parameters3

api_key	string	required	GeodesicAI API key (gai_...)
contract_a	object	required	replay_contract object from one execution
contract_b	object	required	replay_contract object to compare against contract_a

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "GeodesicAI API key (gai_...)",
      "title": "Api Key",
      "type": "string"
    },
    "contract_a": {
      "additionalProperties": true,
      "description": "replay_contract object from one execution",
      "title": "Contract A",
      "type": "object"
    },
    "contract_b": {
      "additionalProperties": true,
      "description": "replay_contract object to compare against contract_a",
      "title": "Contract B",
      "type": "object"
    }
  },
  "required": [
    "api_key",
    "contract_a",
    "contract_b"
  ],
  "title": "verify_replayArguments"
}

account_status

This account's plan, key usage, Blueprint counts, and the deployed platform build fingerprint (version, build, deployed).

Parameters1

api_key

string

required

GeodesicAI API key (gai_...)

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "GeodesicAI API key (gai_...)",
      "title": "Api Key",
      "type": "string"
    }
  },
  "required": [
    "api_key"
  ],
  "title": "account_statusArguments"
}

delete_blueprint

Permanently delete a Blueprint and revoke its API keys. Irreversible; requires confirm=true. Account-level keys are unaffected.

Parameters3

api_key	string	required	GeodesicAI API key (gai_...)
workflow_name	string	required	Blueprint to delete; its API keys are revoked
confirm	boolean	optional	Must be true to confirm this irreversible action

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "GeodesicAI API key (gai_...)",
      "title": "Api Key",
      "type": "string"
    },
    "workflow_name": {
      "description": "Blueprint to delete; its API keys are revoked",
      "title": "Workflow Name",
      "type": "string"
    },
    "confirm": {
      "default": false,
      "description": "Must be true to confirm this irreversible action",
      "title": "Confirm",
      "type": "boolean"
    }
  },
  "required": [
    "api_key",
    "workflow_name"
  ],
  "title": "delete_blueprintArguments"
}

update_blueprint

Update an existing Blueprint in place. Only passed fields change; pass [] to clear a list. workflow_name cannot be renamed and existing API keys keep working. Different from create_blueprint: modifies an existing Blueprint, mints no new key.

Parameters16

api_key	string	required	GeodesicAI API key (gai_...)
workflow_name	string	required	Unique Blueprint identifier; the value passed as 'blueprint' in validate
customer_name	string	optional	Organization or project name (also used for storage folder naming)
mode	string	optional	New mode: observe or enforce; omit to keep current
extracted_fields	array	optional	Field names the agent extracts from source data, e.g. ['vendor','qty','unit_cost']
derived_fields	array	optional	Field names the platform computes from other fields, e.g. ['subtotal','total']
derivation_rules	array	optional	Math rules as objects. Types: add, subtract, multiply, divide, round, copy, sum (multi-operand), items_multiply, items_sum. Each needs 'type' plus its fields; see the blueprint_guide prompt
formal_constraints	array	optional	Constraint objects. Types incl. magnitude_anchor {field,min,max}, relative_anchor {field,reference_field,ratio_min,ratio_max}, max_action_threshold {field,threshold,on_violation}, required_fields {fields}, equals, range, in_set, regex_match, items_magnitude_anchor; see the blueprint_guide prompt
semantic_checks	array	optional	Domain-specific semantic check objects
require_math	boolean	optional	Validate mathematical relationships
require_consistency	boolean	optional	Check internal field consistency
require_coherence	boolean	optional	Check cross-field plausibility
require_provenance	boolean	optional	Require extraction source locations for fields
require_high_assurance	boolean	optional	Strictest mode: every check must pass
enable_anomaly_detection	boolean	optional	Flag records that break no rules but do not fit the reference pattern
enable_drift_tracking	boolean	optional	Track pattern stability across batches

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "GeodesicAI API key (gai_...)",
      "title": "Api Key",
      "type": "string"
    },
    "workflow_name": {
      "description": "Unique Blueprint identifier; the value passed as 'blueprint' in validate",
      "title": "Workflow Name",
      "type": "string"
    },
    "customer_name": {
      "default": null,
      "description": "Organization or project name (also used for storage folder naming)",
      "title": "Customer Name",
      "type": "string"
    },
    "mode": {
      "default": null,
      "description": "New mode: observe or enforce; omit to keep current",
      "title": "Mode",
      "type": "string"
    },
    "extracted_fields": {
      "default": null,
      "description": "Field names the agent extracts from source data, e.g. ['vendor','qty','unit_cost']",
      "items": {},
      "title": "Extracted Fields",
      "type": "array"
    },
    "derived_fields": {
      "default": null,
      "description": "Field names the platform computes from other fields, e.g. ['subtotal','total']",
      "items": {},
      "title": "Derived Fields",
      "type": "array"
    },
    "derivation_rules": {
      "default": null,
      "description": "Math rules as objects. Types: add, subtract, multiply, divide, round, copy, sum (multi-operand), items_multiply, items_sum. Each needs 'type' plus its fields; see the blueprint_guide prompt",
      "items": {},
      "title": "Derivation Rules",
      "type": "array"
    },
    "formal_constraints": {
      "default": null,
      "description": "Constraint objects. Types incl. magnitude_anchor {field,min,max}, relative_anchor {field,reference_field,ratio_min,ratio_max}, max_action_threshold {field,threshold,on_violation}, required_fields {fields}, equals, range, in_set, regex_match, items_magnitude_anchor; see the blueprint_guide prompt",
      "items": {},
      "title": "Formal Constraints",
      "type": "array"
    },
    "semantic_checks": {
      "default": null,
      "description": "Domain-specific semantic check objects",
      "items": {},
      "title": "Semantic Checks",
      "type": "array"
    },
    "require_math": {
      "default": null,
      "description": "Validate mathematical relationships",
      "title": "Require Math",
      "type": "boolean"
    },
    "require_consistency": {
      "default": null,
      "description": "Check internal field consistency",
      "title": "Require Consistency",
      "type": "boolean"
    },
    "require_coherence": {
      "default": null,
      "description": "Check cross-field plausibility",
      "title": "Require Coherence",
      "type": "boolean"
    },
    "require_provenance": {
      "default": null,
      "description": "Require extraction source locations for fields",
      "title": "Require Provenance",
      "type": "boolean"
    },
    "require_high_assurance": {
      "default": null,
      "description": "Strictest mode: every check must pass",
      "title": "Require High Assurance",
      "type": "boolean"
    },
    "enable_anomaly_detection": {
      "default": null,
      "description": "Flag records that break no rules but do not fit the reference pattern",
      "title": "Enable Anomaly Detection",
      "type": "boolean"
    },
    "enable_drift_tracking": {
      "default": null,
      "description": "Track pattern stability across batches",
      "title": "Enable Drift Tracking",
      "type": "boolean"
    }
  },
  "required": [
    "api_key",
    "workflow_name"
  ],
  "title": "update_blueprintArguments"
}

list_api_keys

List this account's API keys (masked) with their Blueprint bindings.

Parameters1

api_key

string

required

GeodesicAI API key (gai_...)

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "GeodesicAI API key (gai_...)",
      "title": "Api Key",
      "type": "string"
    }
  },
  "required": [
    "api_key"
  ],
  "title": "list_api_keysArguments"
}

rotate_api_key

Replace an API key with a fresh one. The old key stops working immediately; the new key inherits its bindings.

Parameters2

api_key	string	required	GeodesicAI API key (gai_...)
key_to_rotate	string	required	The gai_ key to rotate; it stops working immediately

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "GeodesicAI API key (gai_...)",
      "title": "Api Key",
      "type": "string"
    },
    "key_to_rotate": {
      "description": "The gai_ key to rotate; it stops working immediately",
      "title": "Key To Rotate",
      "type": "string"
    }
  },
  "required": [
    "api_key",
    "key_to_rotate"
  ],
  "title": "rotate_api_keyArguments"
}

delete_api_key

Permanently delete one of the caller's API keys. DESTRUCTIVE — agents using the deleted key will receive auth errors immediately. The Blueprint a key was tied to (if any) is NOT affected; only the credential is revoked. To delete a Blueprint and all its keys, use delete_blueprint. The target key can be specified two ways: - As the full key string (gai_...). - As a key_id (SHA-256 hash from list_api_keys).

Parameters3

api_key	string	required	GeodesicAI API key (gai_...)
key_to_delete	string	required	The gai_ key to delete
confirm	boolean	optional	Must be true to confirm this irreversible action

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "GeodesicAI API key (gai_...)",
      "title": "Api Key",
      "type": "string"
    },
    "key_to_delete": {
      "description": "The gai_ key to delete",
      "title": "Key To Delete",
      "type": "string"
    },
    "confirm": {
      "default": false,
      "description": "Must be true to confirm this irreversible action",
      "title": "Confirm",
      "type": "boolean"
    }
  },
  "required": [
    "api_key",
    "key_to_delete"
  ],
  "title": "delete_api_keyArguments"
}

Install

Tools (37)

validatevalidate_repaircreate_blueprintlist_blueprintsrepaircheck_blueprint_healthcompare_semantic_equivalencegovern_inference

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://app.geodesiclabs.ai/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "governance-platform": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://app.geodesiclabs.ai/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

validate

validate_repair

create_blueprint

list_blueprints

repair

check_blueprint_health

compare_semantic_equivalence

govern_inference

get_inference_trace

recent_inference_decisions

verify_certificate

profile_blueprint_robustness

forecast

discover_patterns

repair_path

counterfactual

analyze_anomaly

create_chain

submit_chain_stage

handoff_audit

approve_rule

reject_rule

structural_types

decompose_failure

geometric_confidence

check_realization

check_drift

authorize_execution

load_rule_pack

get_execution_trace

verify_replay

account_status

delete_blueprint

update_blueprint

list_api_keys

rotate_api_key

delete_api_key

Install

Remote endpoint

Related servers