Runledge is the approval gate for AI agents. Rules check every action before it runs.
Maintained by@nosgood-ship-it(verified)Also a maintainer?
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Start a rollback for a multi-step run. Returns the undo steps each action declared, newest first. Runledge does not call providers: execute each step yourself, then call record_action with compensates_action_id. Set dry_run to only read the run state. Requires member role.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http runledge https://runledge.com/mcp
Start a rollback for a multi-step run. Returns the undo steps each action declared, newest first. Runledge does not call providers: execute each step yourself, then call record_action with compensates_action_id. Set dry_run to only read the run state. Requires member role.
| Argument | Type | Description |
|---|---|---|
| reason | string | |
| run_id* | string | |
| dry_run | boolean | |
| workspace_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"workspace_id",
"run_id"
],
"properties": {
"reason": {
"type": "string",
"default": "",
"maxLength": 500
},
"run_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,120}$"
},
"dry_run": {
"type": "boolean",
"default": false
},
"workspace_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
}Draft up to five shadow-mode rules from operational language. Drafting is free and does not consume a paid-plan AI review. Fair-use limit: 20 drafts per hour. Unsupported requirements are flagged; no rules are saved or applied. Requires policy management permission.
| Argument | Type | Description |
|---|---|---|
| text* | string | |
| workspace_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"workspace_id",
"text"
],
"properties": {
"text": {
"type": "string",
"maxLength": 6000,
"minLength": 10
},
"workspace_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
}Evaluate a proposed action against current workspace rules. Returns Allowed / Adjusted / Held / Blocked (compatibility values allowed / shaped / pending_approval / blocked). Adjusted returns shaped_action; callers send that version, never the original. No external action is executed.
| Argument | Type | Description |
|---|---|---|
| action* | object | |
| approval_id | string | |
| workspace_id* | string | |
| payload_sha256 | string | |
| connection_check_id | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"workspace_id",
"action"
],
"properties": {
"action": {
"type": "object",
"required": [
"agent",
"action_type",
"target_system"
],
"properties": {
"agent": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"run_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,120}$"
},
"metadata": {
"type": "object",
"default": {},
"properties": {
"category": {
"type": "string",
"maxLength": 120
},
"evidence": {
"type": "object",
"propertyNames": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"additionalProperties": {
"type": "string",
"maxLength": 2000
}
},
"ad_account": {
"type": "string",
"maxLength": 120
},
"amount_usd": {
"type": "number",
"maximum": 10000000000,
"minimum": 0
},
"input_text": {
"type": "string",
"maxLength": 8000
},
"campaign_id": {
"type": "string",
"maxLength": 120
},
"environment": {
"enum": [
"development",
"staging",
"production"
],
"type": "string"
},
"verified_owner": {
"type": "boolean"
},
"customs_cleared": {
"type": "boolean"
},
"matter_owner_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"account_owner_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"destination_domain": {
"type": "string",
"maxLength": 253
},
"approved_list_member": {
"type": "boolean"
},
"price_above_contract_rate": {
"type": "boolean"
},
"target_differs_from_actor": {
"type": "boolean"
},
"bank_details_changed_recently": {
"type": "boolean"
}
},
"additionalProperties": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
]
}
},
"action_type": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"target_system": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"model_cost_usd": {
"type": "number",
"default": 0,
"maximum": 100000,
"minimum": 0
}
}
},
"approval_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"workspace_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"payload_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"connection_check_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
}Issue or accept an exact partner action ticket after both workspace policies. Administrator only; explicit human review required for probation acceptance. Acceptance records consent, never external execution or financial settlement.
| Argument | Type | Description |
|---|---|---|
| ticket | object | |
| proposal | object | |
| reviewed | boolean | |
| operation* | string | |
| workspace_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"workspace_id",
"operation"
],
"properties": {
"ticket": {
"type": "object",
"required": [
"v",
"iss",
"aud",
"nonce",
"iat",
"exp",
"action",
"action_hash",
"approval_id",
"key_id",
"signature_algorithm",
"signature"
],
"properties": {
"v": {
"type": "string",
"const": "VAT-1"
},
"aud": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"exp": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"iat": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"iss": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"nonce": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"action": {
"type": "object",
"required": [
"action_type",
"target_system"
],
"properties": {
"agent": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"metadata": {
"type": "object",
"default": {},
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"action_type": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"target_system": {
"type": "string",
"maxLength": 200,
"minLength": 1
}
},
"additionalProperties": false
},
"key_id": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"signature": {
"type": "string",
"maxLength": 512,
"minLength": 1
},
"action_hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"approval_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
{
"type": "null"
}
]
},
"signature_algorithm": {
"enum": [
"Ed25519",
"ES256"
],
"type": "string"
}
},
"additionalProperties": false
},
"proposal": {
"type": "object",
"required": [
"audience_org",
"action"
],
"properties": {
"action": {
"type": "object",
"required": [
"action_type",
"target_system"
],
"properties": {
"agent": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"metadata": {
"type": "object",
"default": {},
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"action_type": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"target_system": {
"type": "string",
"maxLength": 200,
"minLength": 1
}
},
"additionalProperties": false
},
"approval_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"passport_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"audience_org": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
},
"reviewed": {
"type": "boolean",
"default": false
},
"operation": {
"enum": [
"issue",
"accept"
],
"type": "string"
},
"workspace_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
}Run a provider API call through a workspace credential the agent never sees. Runledge evaluates policy first and calls the provider only when allowed; the idempotency key guarantees at most one call. Held or Blocked proposals are recorded but not executed. Adjusted proposals are refused: this broker does not rewrite provider requests.
| Argument | Type | Description |
|---|---|---|
| action* | object | |
| request* | object | |
| credential* | string | |
| approval_id | string | |
| workspace_id* | string | |
| idempotency_key* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"workspace_id",
"credential",
"idempotency_key",
"action",
"request"
],
"properties": {
"action": {
"type": "object",
"required": [
"agent",
"action_type",
"target_system"
],
"properties": {
"agent": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"run_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,120}$"
},
"metadata": {
"type": "object",
"default": {},
"properties": {
"category": {
"type": "string",
"maxLength": 120
},
"evidence": {
"type": "object",
"propertyNames": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"additionalProperties": {
"type": "string",
"maxLength": 2000
}
},
"ad_account": {
"type": "string",
"maxLength": 120
},
"amount_usd": {
"type": "number",
"maximum": 10000000000,
"minimum": 0
},
"input_text": {
"type": "string",
"maxLength": 8000
},
"campaign_id": {
"type": "string",
"maxLength": 120
},
"environment": {
"enum": [
"development",
"staging",
"production"
],
"type": "string"
},
"verified_owner": {
"type": "boolean"
},
"customs_cleared": {
"type": "boolean"
},
"matter_owner_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"account_owner_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"destination_domain": {
"type": "string",
"maxLength": 253
},
"approved_list_member": {
"type": "boolean"
},
"price_above_contract_rate": {
"type": "boolean"
},
"target_differs_from_actor": {
"type": "boolean"
},
"bank_details_changed_recently": {
"type": "boolean"
}
},
"additionalProperties": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
]
}
},
"action_type": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"target_system": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"model_cost_usd": {
"type": "number",
"default": 0,
"maximum": 100000,
"minimum": 0
}
}
},
"request": {
"type": "object",
"required": [
"method",
"path"
],
"properties": {
"body": {},
"path": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"method": {
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE"
],
"type": "string"
},
"content_type": {
"enum": [
"application/json",
"application/x-www-form-urlencoded"
],
"type": "string",
"default": "application/json"
}
}
},
"credential": {
"type": "string",
"pattern": "^[a-z0-9_-]{1,40}$"
},
"approval_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"workspace_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"idempotency_key": {
"type": "string",
"maxLength": 200,
"minLength": 8
}
},
"additionalProperties": false
}Check one approval request so a paused agent can resume. When approved, re-run evaluate_action with approval_id before executing the exact same proposal; when rejected, do not execute.
| Argument | Type | Description |
|---|---|---|
| approval_id* | string | |
| workspace_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"workspace_id",
"approval_id"
],
"properties": {
"approval_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"workspace_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
}Read the stored policy decision for an opt-in connection check; not proof of external execution.
| Argument | Type | Description |
|---|---|---|
| id* | string | |
| workspace_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"workspace_id",
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"workspace_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
}Departmental action volume, token spend and estimated operating value. Risk exposure is not realized savings; shared platform cost counted once.
| Argument | Type | Description |
|---|---|---|
| days | integer | |
| workspace_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"workspace_id"
],
"properties": {
"days": {
"type": "integer",
"default": 30,
"maximum": 365,
"minimum": 1
},
"workspace_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
}Return actions, hours saved, losses prevented, token usage, spend and net value for a workspace over the last N days.
| Argument | Type | Description |
|---|---|---|
| days | integer | Lookback window in days. |
| workspace_id* | string | Workspace id from list_workspaces. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"workspace_id"
],
"properties": {
"days": {
"type": "integer",
"default": 30,
"maximum": 365,
"minimum": 1,
"description": "Lookback window in days."
},
"workspace_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "Workspace id from list_workspaces."
}
},
"additionalProperties": false
}Review the last 30 days of agent activity for uncovered actions and volume spikes, and return suggested rules. Suggestions are not applied. Team and above.
| Argument | Type | Description |
|---|---|---|
| workspace_id* | string | Workspace id from list_workspaces. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"workspace_id"
],
"properties": {
"workspace_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "Workspace id from list_workspaces."
}
},
"additionalProperties": false
}List recent agent actions in a workspace, newest first, optionally filtered by status or agent.
| Argument | Type | Description |
|---|---|---|
| agent | string | |
| limit | integer | |
| run_id | string | |
| status | string | |
| workspace_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"workspace_id"
],
"properties": {
"agent": {
"type": "string",
"maxLength": 120
},
"limit": {
"type": "integer",
"default": 25,
"maximum": 200,
"minimum": 1
},
"run_id": {
"type": "string",
"maxLength": 120
},
"status": {
"enum": [
"executed",
"blocked",
"rolled_back",
"pending_approval",
"failed"
],
"type": "string"
},
"workspace_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
}List human-in-the-loop approval requests in a workspace, optionally filtered by status.
| Argument | Type | Description |
|---|---|---|
| status | string | |
| workspace_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"workspace_id"
],
"properties": {
"status": {
"enum": [
"pending",
"approved",
"rejected"
],
"type": "string"
},
"workspace_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
}List the Runledge workspaces the signed-in user can access, with plan and your role. Call this first to get a workspace_id.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {},
"additionalProperties": false
}Administrator operations: publish/revoke agent passports, set partner caps and incoming action vocabulary, run a zero-value staging bilateral policy handshake, or retrieve consent evidence. Handshakes are synthetic and audited on both sides, not live consent or external connectivity. Publishing passports makes scope public by link. Never executes actions, settles funds or changes policies automatically; obtain explicit user consent before mutations.
| Argument | Type | Description |
|---|---|---|
| input* | any |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"oneOf": [
{
"type": "object",
"required": [
"operation",
"workspace_id",
"agent_id"
],
"properties": {
"agent_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"operation": {
"type": "string",
"const": "issue_passport"
},
"ceiling_usd": {
"anyOf": [
{
"type": "number",
"maximum": 1000000000,
"minimum": 0
},
{
"type": "null"
}
],
"default": null
},
"workspace_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"operation",
"workspace_id",
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"operation": {
"type": "string",
"const": "revoke_passport"
},
"workspace_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"operation",
"workspace_id",
"partner_id",
"daily_cap_usd"
],
"properties": {
"operation": {
"type": "string",
"const": "set_limits"
},
"partner_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"workspace_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"daily_cap_usd": {
"anyOf": [
{
"type": "number",
"maximum": 1000000000,
"minimum": 0
},
{
"type": "null"
}
]
},
"probation_exchanges": {
"type": "integer",
"default": 0,
"maximum": 1000,
"minimum": 0
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"operation",
"workspace_id",
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"operation": {
"type": "string",
"const": "get_manifest"
},
"workspace_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"operation",
"workspace_id",
"partner_id",
"action_types"
],
"properties": {
"operation": {
"type": "string",
"const": "set_vocabulary"
},
"partner_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"action_types": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9_.:-]+$",
"maxLength": 120,
"minLength": 1
},
"maxItems": 100
},
"workspace_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"operation",
"workspace_id",
"partner_id",
"action_type",
"target_system"
],
"properties": {
"operation": {
"type": "string",
"const": "test_handshake"
},
"partner_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"action_type": {
"type": "string",
"pattern": "^[A-Za-z0-9_.:-]+$",
"maxLength": 120,
"minLength": 1
},
"workspace_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"target_system": {
"type": "string",
"maxLength": 200,
"minLength": 1
}
},
"additionalProperties": false
}
]
}
},
"additionalProperties": false
}Record an action an agent took (or was blocked from taking) with tokens, cost and value. Pass idempotency_key to make retries safe. Requires member role.
| Argument | Type | Description |
|---|---|---|
| agent* | string | |
| model | string | |
| run_id | string | |
| status* | string | |
| metadata | object | |
| tokens_in | integer | |
| latency_ms | integer | |
| tokens_out | integer | |
| action_type* | string | |
| approval_id | string | |
| cost_center | string | |
| compensation | object | |
| workspace_id* | string | |
| minutes_saved | number | |
| target_system* | string | |
| blocked_reason | string | |
| model_cost_usd | number | |
| idempotency_key | string | |
| decision_record_id | string | |
| value_protected_usd | number | |
| compensates_action_id | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"workspace_id",
"agent",
"action_type",
"target_system",
"status"
],
"properties": {
"agent": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"model": {
"type": "string",
"maxLength": 120
},
"run_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,120}$"
},
"status": {
"enum": [
"executed",
"blocked",
"rolled_back",
"pending_approval",
"failed"
],
"type": "string"
},
"metadata": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tokens_in": {
"type": "integer",
"default": 0,
"maximum": 10000000,
"minimum": 0
},
"latency_ms": {
"type": "integer",
"default": 0,
"maximum": 86400000,
"minimum": 0
},
"tokens_out": {
"type": "integer",
"default": 0,
"maximum": 10000000,
"minimum": 0
},
"action_type": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"approval_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"cost_center": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,40}$"
},
"compensation": {
"type": "object",
"required": [
"action_type",
"target_system"
],
"properties": {
"metadata": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"action_type": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"target_system": {
"type": "string",
"maxLength": 120,
"minLength": 1
}
}
},
"workspace_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"minutes_saved": {
"type": "number",
"default": 0,
"maximum": 100000,
"minimum": 0
},
"target_system": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"blocked_reason": {
"type": "string",
"maxLength": 500
},
"model_cost_usd": {
"type": "number",
"default": 0,
"maximum": 100000,
"minimum": 0
},
"idempotency_key": {
"type": "string",
"maxLength": 200
},
"decision_record_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"value_protected_usd": {
"type": "number",
"default": 0,
"maximum": 1000000000,
"minimum": 0
},
"compensates_action_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
}Put a high-impact action in the workspace approval queue for a human owner or admin to approve or reject in the Runledge console.
| Argument | Type | Description |
|---|---|---|
| summary* | string | Plain-language description of what will happen. |
| amount_usd | number | |
| requested_by | string | |
| workspace_id* | string | |
| proposed_action | object | Exact proposed action from evaluate_action; requires the quorum set by the failing rules (1–5 distinct reviewers; admins only if a rule says so). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"workspace_id",
"summary"
],
"properties": {
"summary": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "Plain-language description of what will happen."
},
"amount_usd": {
"type": "number",
"minimum": 0
},
"requested_by": {
"type": "string",
"default": "mcp-agent",
"maxLength": 120,
"minLength": 1
},
"workspace_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"proposed_action": {
"type": "object",
"required": [
"agent",
"action_type",
"target_system"
],
"properties": {
"agent": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"run_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,120}$"
},
"metadata": {
"type": "object",
"default": {},
"properties": {
"category": {
"type": "string",
"maxLength": 120
},
"evidence": {
"type": "object",
"propertyNames": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"additionalProperties": {
"type": "string",
"maxLength": 2000
}
},
"ad_account": {
"type": "string",
"maxLength": 120
},
"amount_usd": {
"type": "number",
"maximum": 10000000000,
"minimum": 0
},
"input_text": {
"type": "string",
"maxLength": 8000
},
"campaign_id": {
"type": "string",
"maxLength": 120
},
"environment": {
"enum": [
"development",
"staging",
"production"
],
"type": "string"
},
"verified_owner": {
"type": "boolean"
},
"customs_cleared": {
"type": "boolean"
},
"matter_owner_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"account_owner_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"destination_domain": {
"type": "string",
"maxLength": 253
},
"approved_list_member": {
"type": "boolean"
},
"price_above_contract_rate": {
"type": "boolean"
},
"target_differs_from_actor": {
"type": "boolean"
},
"bank_details_changed_recently": {
"type": "boolean"
}
},
"additionalProperties": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
]
}
},
"action_type": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"target_system": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"model_cost_usd": {
"type": "number",
"default": 0,
"maximum": 100000,
"minimum": 0
}
},
"description": "Exact proposed action from evaluate_action; requires the quorum set by the failing rules (1–5 distinct reviewers; admins only if a rule says so)."
}
},
"additionalProperties": false
}Search Runledge API contracts and developer FAQs; cite returned sources when explaining integrations. Does not execute examples or change permissions.
| Argument | Type | Description |
|---|---|---|
| query* | string | API endpoint, integration topic or developer question. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "API endpoint, integration topic or developer question."
}
},
"additionalProperties": false
}Open a ten-minute connection check. Pass its id as connection_check_id to evaluate_action or REST preflight; this executes no external action.
| Argument | Type | Description |
|---|---|---|
| workspace_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"workspace_id"
],
"properties": {
"workspace_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
}Send one synthetic non-actionable notification or velocity-trip example to a subscribed channel. Requires policy management permission; one test per minute. Does not verify reviewer decisions.
| Argument | Type | Description |
|---|---|---|
| event | string | |
| endpoint_id* | string | |
| workspace_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"workspace_id",
"endpoint_id"
],
"properties": {
"event": {
"enum": [
"approval.requested",
"alert.velocity_trip"
],
"type": "string",
"default": "approval.requested"
},
"endpoint_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"workspace_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 22, 2026.
Takes a password, API key or token as an argument, so the secret passes through the model's context and chat logs.
Fix: Read credentials from the server's own configuration (environment, OAuth) instead of a tool argument.