_ registry / mcp http-sse · checked 2h ago

surrealdb-cloud

https://api.surrealdb.com

Registry code: c2d17d35aee712e4

api record

SurrealDB Cloud MCP — agent workflow guide

WHEN YOU NEED SURREALDB SYNTAX, CONFIGURATION OR SDK USAGE:

endpoint
https://api.surrealdb.com/api/mcp
protocol
http-sse ·2025-06-18
authentication
none observed
public key
none — nobody has proven they own this listing · is it yours? claim it
karma
0 · newcomer
_ is it live, free and safe measured by this hub
Is surrealdb-cloud live?
Yes — it answered the hub's last check (checked 2h ago). It answered 100% of checks over the last 30 days.
Is surrealdb-cloud free to use?
Not anonymously — it asks for a key or a login before it will serve. Whether that key costs anything is the operator's plan to say: the hub measured the door, not the pricing.
What tools does surrealdb-cloud have?
82 tools: call_agent_memory_chat, list_agent_memory_entities, list_agent_memory_documents, search_agent_memory_documents, list_agent_memory_context_scopes, create_agent_memory_context_scope, get_agent_memory_context_config, list_agent_memory_context_providers, ….
Is surrealdb-cloud safe to connect?
The hub found no text in its card or tool descriptions aimed at the agent reading them. It measures what the server answers, not its code — grant it only the access its tools need.
reachable
live
uptime, 30 days
100%

90 days 100%· all time 100%

latency
349ms

last good check

priced tools
0

of 82 tools

_ answered our checks, 90 days 1 checks · signed record
  • unknown → live
_ usage and payments 30 days

Calls placed through this hub's router, from its own receipts. Every caller and every payer counts the same; the chain total is counted from three payers.

accounts
0

through this hub

calls served
0

successful

paid through this hub
0 USDC

what callers paid

_ what it can do 82 tools
82 auth-required 82 of 82 classified

Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.

  • call_agent_memory_chat auth-required never probed

    One chat turn: retrieve memory, call the context's model, store the exchange, and return the reply with what memory changed. Omit `session_id` to start a new session.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "context_id",
    "message"
  ],
  "properties": {
    "labels": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 128,
        "minLength": 1
      },
      "maxItems": 32,
      "description": "Optional labels attached to persisted rows."
    },
    "scopes": {
      "type": "array",
      "items": {
        "type": "array",
        "items": {
          "type": "string",
          "maxLength": 256,
          "minLength": 1
        },
        "minItems": 1
      },
      "description": "DNF scope for rows this chat persists (when starting a new session)."
    },
    "message": {
      "type": "string",
      "maxLength": 16384,
      "minLength": 1,
      "description": "User message for this turn."
    },
    "context_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "Agent Memory context `id` from list_agent_memory_contexts."
    },
    "session_id": {
      "type": "string",
      "maxLength": 128,
      "minLength": 1,
      "description": "Existing session id from create_agent_memory_session."
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "Required. Organisation `id` from `list_organizations` (`id`, not display name)."
    }
  }
}
    arguments 56 lines
  • list_agent_memory_entities auth-required never probed

    The entities an Agent Memory context holds. call_agent_memory_tool `inspect` with `entity:Type/Name` shows one in full.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "context_id"
  ],
  "properties": {
    "context_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "Agent Memory context `id` from list_agent_memory_contexts."
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "Required. Organisation `id` from `list_organizations` (`id`, not display name)."
    }
  }
}
    arguments 20 lines
  • list_agent_memory_documents auth-required never probed

    A context's ingested documents, a page at a time.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "context_id"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 10000,
      "minimum": 0,
      "description": "Zero-based page index (default 0)."
    },
    "status": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "Filter by document status."
    },
    "mime_type": {
      "type": "string",
      "maxLength": 128,
      "minLength": 1,
      "description": "Filter by MIME type."
    },
    "page_size": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Page size (default 20, max 100)."
    },
    "context_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "Agent Memory context `id` from list_agent_memory_contexts."
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "Required. Organisation `id` from `list_organizations` (`id`, not display name)."
    }
  }
}
    arguments 44 lines
  • search_agent_memory_documents auth-required never probed

    Semantic search over a context's ingested documents. call_agent_memory_tool `recall` searches memory instead.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "context_id",
    "query"
  ],
  "properties": {
    "k": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Number of hits (default 10)."
    },
    "mode": {
      "enum": [
        "vector",
        "bm25",
        "hybrid",
        "hybrid_graph"
      ],
      "type": "string",
      "description": "Retrieval mode (default hybrid)."
    },
    "query": {
      "type": "string",
      "maxLength": 4096,
      "minLength": 1
    },
    "context_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "Agent Memory context `id` from list_agent_memory_contexts."
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "Required. Organisation `id` from `list_organizations` (`id`, not display name)."
    }
  }
}
    arguments 42 lines
  • list_agent_memory_context_scopes auth-required never probed

    The scope paths registered on a context.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "context_id"
  ],
  "properties": {
    "under": {
      "type": "string",
      "maxLength": 256,
      "minLength": 1,
      "description": "Optional parent scope path filter (may be ignored by the Cloud API)."
    },
    "context_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "Agent Memory context `id` from list_agent_memory_contexts."
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "Required. Organisation `id` from `list_organizations` (`id`, not display name)."
    }
  }
}
    arguments 26 lines
  • create_agent_memory_context_scope auth-required never probed

    Register a scope path, and any missing parents, before memory is written under it. The caller's principal needs `scope:create`.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "context_id",
    "path"
  ],
  "properties": {
    "path": {
      "type": "string",
      "maxLength": 512,
      "minLength": 1,
      "description": "Hierarchical scope path, e.g. \"org/acme/user/alice\" or \"org/acme/project/my-repo/\" (trailing slash optional)."
    },
    "context_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "Agent Memory context `id` from list_agent_memory_contexts."
    },
    "description": {
      "type": "string",
      "maxLength": 1024,
      "minLength": 1,
      "description": "Optional description for the scope node."
    },
    "display_name": {
      "type": "string",
      "maxLength": 256,
      "minLength": 1,
      "description": "Optional UI display name for the scope node."
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "Required. Organisation `id` from `list_organizations` (`id`, not display name)."
    }
  }
}
    arguments 39 lines
  • get_agent_memory_context_config auth-required never probed

    A context's configuration: token limits and feature flags. Provider keys are never returned.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "context_id"
  ],
  "properties": {
    "context_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "Agent Memory context `id` from list_agent_memory_contexts."
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$"
    }
  }
}
    arguments 19 lines
  • list_agent_memory_context_providers auth-required never probed

    The model providers and models a context is configured with.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "context_id"
  ],
  "properties": {
    "context_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "Agent Memory context `id` from list_agent_memory_contexts."
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$"
    }
  }
}
    arguments 19 lines
  • list_billing_countries auth-required never probed

    The countries a billing contact can be in.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
    arguments 5 lines
  • list_organizations auth-required never probed

    The user's organisations. An `id` here is the `organization_id` other tools take.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
    arguments 5 lines
  • update_organization auth-required never probed

    Rename an organisation.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 30,
      "minLength": 1,
      "description": "New display name (1–30 characters)."
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$"
    }
  }
}
    arguments 20 lines
  • list_products auth-required never probed

    What an organisation can deploy. A product's `slug` is the `product` argument of the cluster tools, its `features` say which instance-only tools apply, and `deploy_schema` / `update_schema` shape the `configuration` of deploy_cluster and update_cluster.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id"
  ],
  "properties": {
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "From list_organizations."
    }
  }
}
    arguments 14 lines
  • get_organization_billing_requirements auth-required never probed

    The billing contact's required and optional fields, their snake_case aliases, and valid country codes.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
    arguments 5 lines
  • copy_organization_billing_from auth-required never probed

    Copy the billing contact, not payment methods, from another organisation the user belongs to.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "target_organization_id",
    "source_organization_id"
  ],
  "properties": {
    "source_organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "Organisation to copy billing contact from (must have billing_info: true)"
    },
    "target_organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "Organisation that needs billing contact (destination)"
    }
  }
}
    arguments 20 lines
  • assign_organization_agent_memory_context_package auth-required never probed

    Subscribe an organisation to an Agent Memory package, which shared contexts need.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "package_id"
  ],
  "properties": {
    "package_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "Catalog package `id` from list_agent_memory_context_packages."
    },
    "coupon_code": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$"
    }
  }
}
    arguments 24 lines
  • get_agent_memory_snapshot auth-required never probed

    A context's structured memory: its `state` and `profile`.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "context_id"
  ],
  "properties": {
    "context_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "Agent Memory context `id` from list_agent_memory_contexts."
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "Required. Organisation `id` from `list_organizations` (`id`, not display name)."
    }
  }
}
    arguments 20 lines
  • get_cloud_terms_acceptance_status auth-required 2h ago

    Whether the user has accepted the Cloud terms.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
    arguments 5 lines
  • get_cloud_terms_and_conditions auth-required 2h ago

    The Cloud legal documents to show the user before accept_cloud_terms_and_conditions.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
    arguments 5 lines
  • get_organization auth-required never probed

    An organisation by id.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id"
  ],
  "properties": {
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$"
    }
  }
}
    arguments 13 lines
  • create_organization auth-required never probed

    Create an organisation. A new one often has no free instance quota, so check get_organization_deployment_readiness before deploying.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 30,
      "minLength": 1,
      "description": "Display name (1–30 characters, same as SurrealDB Studio)."
    }
  }
}
    arguments 15 lines
  • deploy_cluster auth-required never probed

    Deploy a cluster: a database instance (dedicated or SurrealDB Earth) or an Agent Memory context. Check get_organization_deployment_readiness first. The new cluster is usually `creating`; poll get_cluster until `ready`.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "product",
    "configuration"
  ],
  "properties": {
    "product": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "Product slug, from list_products or the cluster's listing."
    },
    "configuration": {
      "type": "object",
      "description": "Shaped by the product's schema in list_products.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "From list_organizations."
    }
  }
}
    arguments 30 lines
  • get_cluster auth-required never probed

    A database instance or Agent Memory context: its state, version, host, current `capabilities` and product details.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "product",
    "cluster_id"
  ],
  "properties": {
    "product": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "Product slug, from list_products or the cluster's listing."
    },
    "cluster_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "From list_instances or list_agent_memory_contexts."
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "From list_organizations."
    }
  }
}
    arguments 27 lines
  • update_cluster auth-required never probed

    Change a cluster. Unnamed capabilities keep their value, and a locked one (`capability_rules`) is refused. Changes apply in order and stop at the first refusal; retry `not_attempted` once the cluster is `ready`.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "product",
    "cluster_id",
    "configuration"
  ],
  "properties": {
    "product": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "Product slug, from list_products or the cluster's listing."
    },
    "cluster_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "From list_instances or list_agent_memory_contexts."
    },
    "configuration": {
      "type": "object",
      "description": "Shaped by the product's schema in list_products.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "From list_organizations."
    }
  }
}
    arguments 36 lines
  • delete_cluster auth-required never probed

    Permanently delete a cluster and its data, backups included. `confirm_cluster_name` must equal its current name.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "product",
    "cluster_id",
    "confirm_cluster_name"
  ],
  "properties": {
    "product": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "Product slug, from list_products or the cluster's listing."
    },
    "cluster_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "From list_instances or list_agent_memory_contexts."
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "From list_organizations."
    },
    "confirm_cluster_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "Must equal cluster_id when given."
    },
    "confirm_cluster_name": {
      "type": "string",
      "maxLength": 256,
      "minLength": 1
    }
  }
}
    arguments 38 lines
  • get_cluster_usage auth-required never probed

    This billing period's usage. Its shape depends on the product; SurrealDB Earth's meters are under `earth`.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "product",
    "cluster_id"
  ],
  "properties": {
    "product": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "Product slug, from list_products or the cluster's listing."
    },
    "cluster_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "From list_instances or list_agent_memory_contexts."
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "From list_organizations."
    }
  }
}
    arguments 27 lines
  • estimate_cluster_cost auth-required never probed

    What deploying with this `configuration` would cost, by the product's `traits.pricing`: a quote, list prices with the monthly free allowance, or the package that covers it.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "product",
    "configuration"
  ],
  "properties": {
    "product": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "Product slug, from list_products or the cluster's listing."
    },
    "configuration": {
      "type": "object",
      "description": "Shaped by the product's schema in list_products.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "From list_organizations."
    }
  }
}
    arguments 30 lines
  • list_instances auth-required never probed

    Index of an organisation's database instances, dedicated and SurrealDB Earth together. `warnings` names what could not be read, so an instance missing from a partial list is not deleted.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id"
  ],
  "properties": {
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "From list_organizations."
    }
  }
}
    arguments 14 lines
  • pause_instance auth-required never probed

    Stop an instance's compute; its data is kept. Needs the `pause` feature.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "product",
    "instance_id"
  ],
  "properties": {
    "product": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "Product slug, from list_products or the cluster's listing."
    },
    "instance_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "From list_instances."
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "From list_organizations."
    }
  }
}
    arguments 27 lines
  • resume_instance auth-required never probed

    Start a paused instance again. Needs the `pause` feature.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "product",
    "instance_id"
  ],
  "properties": {
    "product": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "Product slug, from list_products or the cluster's listing."
    },
    "instance_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "From list_instances."
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "From list_organizations."
    }
  }
}
    arguments 27 lines
  • get_instance_database_token auth-required never probed

    Mint an Owner database token (about 10 minutes) and the endpoints to connect a SurrealDB SDK with it. Mint again on every reconnect. Prefer call_instance_tool where the instance offers `query`.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "product",
    "instance_id"
  ],
  "properties": {
    "product": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "Product slug, from list_products or the cluster's listing."
    },
    "instance_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "From list_instances."
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "From list_organizations."
    }
  }
}
    arguments 27 lines
  • get_instance_backup_policy auth-required never probed

    Backup retention tiers and frequency, with each tier's editable/min/max for `backup_policy` in update_cluster. Needs the `backups` feature.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "product",
    "instance_id"
  ],
  "properties": {
    "product": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "Product slug, from list_products or the cluster's listing."
    },
    "instance_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "From list_instances."
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "From list_organizations."
    }
  }
}
    arguments 27 lines
  • remove_organization_member auth-required never probed

    Remove a member from an organisation.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "member_user_id"
  ],
  "properties": {
    "member_user_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "`user_id` from list_organization_members."
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$"
    }
  }
}
    arguments 19 lines
  • get_instance_spend auth-required never probed

    What an instance has been charged this billing period, entry by entry. Needs the `spend` feature.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "product",
    "instance_id"
  ],
  "properties": {
    "product": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "Product slug, from list_products or the cluster's listing."
    },
    "instance_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "From list_instances."
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "From list_organizations."
    }
  }
}
    arguments 27 lines
  • get_instance_status auth-required never probed

    An instance's status, including its backups. Needs the `backups` feature.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "product",
    "instance_id"
  ],
  "properties": {
    "product": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "Product slug, from list_products or the cluster's listing."
    },
    "instance_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "From list_instances."
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "From list_organizations."
    }
  }
}
    arguments 27 lines
  • list_agent_memory_context_principals auth-required never probed

    A context's principals and their grants.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "context_id"
  ],
  "properties": {
    "context_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "Agent Memory context `id` from list_agent_memory_contexts."
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$"
    }
  }
}
    arguments 19 lines
  • delete_agent_memory_context_principal auth-required never probed

    Delete a principal.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "context_id",
    "principal_id"
  ],
  "properties": {
    "context_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "Agent Memory context `id` from list_agent_memory_contexts."
    },
    "principal_id": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "Principal `id` from list_agent_memory_context_principals."
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$"
    }
  }
}
    arguments 26 lines
  • call_instance_tool auth-required never probed

    Call a tool on an instance's own MCP server: `query` takes `{ query }` (SurrealQL), and `use` takes `{ namespace, database }`, which later calls keep. list_instance_tools lists the rest. Needs the `query` feature; otherwise connect with get_instance_database_token.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "product",
    "instance_id",
    "tool"
  ],
  "properties": {
    "tool": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "e.g. query, use, select, list."
    },
    "product": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "Product slug, from list_products or the cluster's listing."
    },
    "arguments": {
      "type": "object",
      "description": "Arguments forwarded verbatim to the instance MCP tool.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "instance_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "From list_instances."
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "From list_organizations."
    }
  }
}
    arguments 42 lines
  • list_instance_tools auth-required never probed

    The tools an instance's own MCP server offers, with their input schemas. Needs the `query` feature.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "product",
    "instance_id"
  ],
  "properties": {
    "product": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "Product slug, from list_products or the cluster's listing."
    },
    "instance_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "From list_instances."
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "From list_organizations."
    }
  }
}
    arguments 27 lines
  • get_instance_metrics auth-required never probed

    One metric of an instance over a time window. Needs the `monitoring` feature.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "product",
    "instance_id",
    "metric",
    "from_time",
    "to_time"
  ],
  "properties": {
    "metric": {
      "type": "string",
      "maxLength": 128,
      "minLength": 1
    },
    "product": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "Product slug, from list_products or the cluster's listing."
    },
    "to_time": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "ISO 8601."
    },
    "from_time": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "ISO 8601."
    },
    "dummy_data": {
      "type": "boolean",
      "description": "Sample data, for trying the tool."
    },
    "instance_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "From list_instances."
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "From list_organizations."
    }
  }
}
    arguments 51 lines
  • get_instance_logs auth-required never probed

    An instance's logs over a time window. Needs the `monitoring` feature.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "product",
    "instance_id",
    "from_time",
    "to_time"
  ],
  "properties": {
    "product": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "Product slug, from list_products or the cluster's listing."
    },
    "to_time": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "ISO 8601."
    },
    "from_time": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "ISO 8601."
    },
    "instance_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "From list_instances."
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "From list_organizations."
    }
  }
}
    arguments 41 lines
  • get_organization_deployment_readiness auth-required never probed

    Whether each product can be deployed now, and what blocks it with how to fix it. Call before deploy_cluster; `warnings` names checks that could not be made.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id"
  ],
  "properties": {
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$"
    }
  }
}
    arguments 13 lines
  • get_organization_billing auth-required never probed

    An organisation's billing contact.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id"
  ],
  "properties": {
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$"
    }
  }
}
    arguments 13 lines
  • update_organization_billing auth-required never probed

    Set the billing contact and address, with Cloud's PascalCase keys (Name, Email, AddressLine1, …) or their snake_case aliases. Payment methods are added through get_organization_payment_setup_url.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "billing"
  ],
  "properties": {
    "billing": {
      "type": "object",
      "properties": {
        "City": {
          "type": "string",
          "maxLength": 100,
          "minLength": 1
        },
        "Name": {
          "type": "string",
          "maxLength": 100,
          "minLength": 1
        },
        "Email": {
          "type": "string",
          "maxLength": 100,
          "minLength": 7
        },
        "Phone": {
          "type": "string",
          "maxLength": 20,
          "minLength": 7
        },
        "State": {
          "type": "string",
          "maxLength": 100,
          "minLength": 2
        },
        "Country": {
          "type": "string",
          "maxLength": 2,
          "minLength": 2
        },
        "Zipcode": {
          "type": "string",
          "maxLength": 10,
          "minLength": 4
        },
        "LegalName": {
          "type": "string",
          "maxLength": 100,
          "minLength": 1
        },
        "AddressLine1": {
          "type": "string",
          "maxLength": 200,
          "minLength": 1
        },
        "AddressLine2": {
          "type": "string",
          "maxLength": 200
        },
        "TaxIdentificationNumber": {
          "type": "string",
          "maxLength": 20,
          "minLength": 9
        }
      },
      "additionalProperties": false
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$"
    }
  }
}
    arguments 74 lines
  • setup_organization_for_instances auth-required never probed

    Billing setup in one call: copy the contact from another organisation or set it, get a payment setup URL, and report deployment readiness.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id"
  ],
  "properties": {
    "billing": {
      "type": "object",
      "description": "Optional billing contact fields (PascalCase or snake_case aliases)",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$"
    },
    "copy_billing_from_org": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "Optional source org id to copy billing contact from"
    },
    "request_payment_setup_url": {
      "type": "boolean",
      "description": "When true, include payment_setup_url in the response if billing contact is complete"
    }
  }
}
    arguments 30 lines
  • list_invoices auth-required never probed

    An organisation's invoices.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id"
  ],
  "properties": {
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$"
    }
  }
}
    arguments 13 lines
  • list_billing_coupons auth-required never probed

    The coupons applied to an organisation.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id"
  ],
  "properties": {
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$"
    }
  }
}
    arguments 13 lines
  • get_organization_payment auth-required never probed

    An organisation's payment method, summarised.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id"
  ],
  "properties": {
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$"
    }
  }
}
    arguments 13 lines
  • get_organization_payment_setup_url auth-required never probed

    A Stripe Checkout URL where the user adds a payment method in their browser. Needs the billing contact first. Never take card details as tool arguments.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id"
  ],
  "properties": {
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$"
    }
  }
}
    arguments 13 lines
  • get_organization_payment_portal_url auth-required never probed

    The same as get_organization_payment_setup_url.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id"
  ],
  "properties": {
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$"
    }
  }
}
    arguments 13 lines
  • get_organization_usage auth-required never probed

    This calendar month's (UTC) usage across instances and clusters. `earth_allowance` is SurrealDB Earth use against each free allowance: a free organisation over one has its Earth clusters disabled.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id"
  ],
  "properties": {
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "From list_organizations."
    }
  }
}
    arguments 14 lines
  • list_organization_members auth-required never probed

    An organisation's members. A member's `user_id` is what the member tools take.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id"
  ],
  "properties": {
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$"
    }
  }
}
    arguments 13 lines
  • list_organization_roles auth-required never probed

    The roles a member can have.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id"
  ],
  "properties": {
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$"
    }
  }
}
    arguments 13 lines
  • update_organization_member_role auth-required never probed

    Change a member's role.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "member_user_id",
    "role"
  ],
  "properties": {
    "role": {
      "type": "string",
      "maxLength": 128,
      "minLength": 1
    },
    "member_user_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "`user_id` from list_organization_members."
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$"
    }
  }
}
    arguments 25 lines
  • list_organization_invitations auth-required never probed

    An organisation's pending invitations.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id"
  ],
  "properties": {
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$"
    }
  }
}
    arguments 13 lines
  • invite_organization_member auth-required never probed

    Invite someone to an organisation by email.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "email",
    "role"
  ],
  "properties": {
    "role": {
      "type": "string",
      "maxLength": 128,
      "minLength": 1
    },
    "email": {
      "type": "string",
      "format": "email",
      "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      "maxLength": 320
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$"
    }
  }
}
    arguments 26 lines
  • revoke_organization_invitation auth-required never probed

    Revoke a pending invitation.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "invitation_code"
  ],
  "properties": {
    "invitation_code": {
      "type": "string",
      "maxLength": 256,
      "minLength": 1
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$"
    }
  }
}
    arguments 19 lines
  • list_context_regions auth-required never probed

    The regions shared Agent Memory contexts can be deployed in.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
    arguments 5 lines
  • list_agent_memory_context_packages auth-required never probed

    The Agent Memory packages on offer, with their prices and limits.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
    arguments 5 lines
  • list_organization_agent_memory_context_packages auth-required never probed

    The Agent Memory packages an organisation has.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id"
  ],
  "properties": {
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$"
    }
  }
}
    arguments 13 lines
  • cancel_organization_agent_memory_context_package auth-required never probed

    Cancel an organisation's Agent Memory package. `package_id` is the catalogue package's id.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "package_id"
  ],
  "properties": {
    "package_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "Catalog `package_id` of the active org package to cancel."
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$"
    }
  }
}
    arguments 19 lines
  • list_agent_memory_contexts auth-required never probed

    An organisation's Agent Memory contexts. A context's `id` is the `context_id` the Agent Memory tools take; deploy, rename and delete contexts with the cluster tools.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id"
  ],
  "properties": {
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "From list_organizations."
    }
  }
}
    arguments 14 lines
  • list_agent_memory_context_api_keys auth-required never probed

    A context's API keys, without their secrets.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "context_id"
  ],
  "properties": {
    "context_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "Agent Memory context `id` from list_agent_memory_contexts."
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$"
    }
  }
}
    arguments 19 lines
  • delete_agent_memory_context_api_key auth-required never probed

    Revoke an API key.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "context_id",
    "api_key_id"
  ],
  "properties": {
    "api_key_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "API key `id` from list_agent_memory_context_api_keys."
    },
    "context_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "Agent Memory context `id` from list_agent_memory_contexts."
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$"
    }
  }
}
    arguments 25 lines
  • rotate_agent_memory_context_api_key auth-required never probed

    Replace an API key's secret. The returned `key` is shown only once.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "context_id",
    "api_key_id"
  ],
  "properties": {
    "api_key_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "API key `id` from list_agent_memory_context_api_keys."
    },
    "context_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "Agent Memory context `id` from list_agent_memory_contexts."
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$"
    }
  }
}
    arguments 25 lines
  • mint_agent_memory_scoped_key auth-required never probed

    Mint an API key for a principal, optionally with `grants` narrower than the principal's own. A returned `key` is shown only once.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "context_id",
    "principal_id",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 256,
      "minLength": 1
    },
    "grants": {
      "type": "object",
      "description": "Per-verb map of scope-pattern lists (e.g. memory:read → [\"team/*\"]).",
      "propertyNames": {
        "type": "string",
        "maxLength": 64,
        "minLength": 1
      },
      "additionalProperties": {
        "type": "array",
        "items": {
          "type": "string",
          "maxLength": 256,
          "minLength": 1
        }
      }
    },
    "context_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "Agent Memory context `id` from list_agent_memory_contexts."
    },
    "principal_id": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "Principal `id` from list_agent_memory_context_principals."
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$"
    }
  }
}
    arguments 49 lines
  • mint_agent_memory_access_token auth-required never probed

    Mint a short-lived access token for the caller's own Agent Memory principal, for SDK use. A returned `key` is shown only once.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "context_id"
  ],
  "properties": {
    "context_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "Agent Memory context `id` from list_agent_memory_contexts."
    },
    "ttl_seconds": {
      "type": "integer",
      "maximum": 86400,
      "minimum": 60
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$"
    }
  }
}
    arguments 24 lines
  • create_agent_memory_context_principal auth-required never probed

    Create a principal on a context.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "context_id",
    "kind",
    "display_name"
  ],
  "properties": {
    "kind": {
      "enum": [
        "human",
        "agent",
        "service",
        "unknown"
      ],
      "type": "string"
    },
    "grants": {
      "type": "object",
      "description": "Per-verb map of scope-pattern lists (e.g. memory:read → [\"team/*\"]).",
      "propertyNames": {
        "type": "string",
        "maxLength": 64,
        "minLength": 1
      },
      "additionalProperties": {
        "type": "array",
        "items": {
          "type": "string",
          "maxLength": 256,
          "minLength": 1
        }
      }
    },
    "context_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "Agent Memory context `id` from list_agent_memory_contexts."
    },
    "display_name": {
      "type": "string",
      "maxLength": 256,
      "minLength": 1
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$"
    }
  }
}
    arguments 52 lines
  • update_agent_memory_context_principal auth-required never probed

    Rename a principal or change its kind.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "context_id",
    "principal_id"
  ],
  "properties": {
    "kind": {
      "enum": [
        "human",
        "agent",
        "service",
        "unknown"
      ],
      "type": "string"
    },
    "context_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "Agent Memory context `id` from list_agent_memory_contexts."
    },
    "display_name": {
      "type": "string",
      "maxLength": 256,
      "minLength": 1
    },
    "principal_id": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "Principal `id` from list_agent_memory_context_principals."
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$"
    }
  }
}
    arguments 40 lines
  • replace_agent_memory_principal_grants auth-required never probed

    Replace all of a principal's grants.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "context_id",
    "principal_id",
    "grants"
  ],
  "properties": {
    "grants": {
      "type": "object",
      "description": "Per-verb map of scope-pattern lists (e.g. memory:read → [\"team/*\"]).",
      "propertyNames": {
        "type": "string",
        "maxLength": 64,
        "minLength": 1
      },
      "additionalProperties": {
        "type": "array",
        "items": {
          "type": "string",
          "maxLength": 256,
          "minLength": 1
        }
      }
    },
    "context_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "Agent Memory context `id` from list_agent_memory_contexts."
    },
    "principal_id": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "Principal `id` from list_agent_memory_context_principals."
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$"
    }
  }
}
    arguments 44 lines
  • add_agent_memory_context_user auth-required never probed

    Add an organisation member to a context as a human principal.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "context_id",
    "user_id"
  ],
  "properties": {
    "user_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "Cloud member `user_id` from list_organization_members."
    },
    "context_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "Agent Memory context `id` from list_agent_memory_contexts."
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$"
    }
  }
}
    arguments 25 lines
  • call_agent_memory_tool auth-required never probed

    Call a tool on an Agent Memory context's own MCP server, e.g. `remember` with `{ text, scope? }` or `recall` with `{ query, k? }`; list_agent_memory_tools lists the rest. A new scope path needs create_agent_memory_context_scope before anything is written to it.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "context_id",
    "tool"
  ],
  "properties": {
    "tool": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "Name of the Agent Memory MCP tool to invoke (e.g. remember, recall, context, upload)."
    },
    "arguments": {
      "type": "object",
      "description": "Arguments forwarded verbatim to the Agent Memory MCP tool.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "context_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "Agent Memory context `id` from `list_agent_memory_contexts` or `get_cluster`."
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "Required. Organisation `id` from `list_organizations` (`id`, not display name)."
    }
  }
}
    arguments 35 lines
  • list_agent_memory_tools auth-required never probed

    The tools an Agent Memory context's own MCP server offers, with their input schemas.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "context_id"
  ],
  "properties": {
    "context_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "Agent Memory context `id` from `list_agent_memory_contexts` or `get_cluster`."
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "Required. Organisation `id` from `list_organizations` (`id`, not display name)."
    }
  }
}
    arguments 20 lines
  • delete_agent_memory_context_scope auth-required never probed

    Tombstone a scope path. The memory under it is kept; call_agent_memory_tool `forget` removes that.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "context_id",
    "path"
  ],
  "properties": {
    "path": {
      "type": "string",
      "maxLength": 512,
      "minLength": 1,
      "description": "Hierarchical scope path, e.g. \"org/acme/user/alice\" or \"org/acme/project/my-repo/\" (trailing slash optional)."
    },
    "context_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "Agent Memory context `id` from list_agent_memory_contexts."
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "Required. Organisation `id` from `list_organizations` (`id`, not display name)."
    }
  }
}
    arguments 27 lines
  • create_agent_memory_session auth-required never probed

    Start a chat session; pass its `id` as `session_id` to call_agent_memory_chat.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "context_id"
  ],
  "properties": {
    "scopes": {
      "type": "array",
      "items": {
        "type": "array",
        "items": {
          "type": "string",
          "maxLength": 256,
          "minLength": 1
        },
        "minItems": 1
      },
      "description": "DNF scope selector, e.g. [[\"org/acme/user/alice\"]]."
    },
    "context_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "Agent Memory context `id` from list_agent_memory_contexts."
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "Required. Organisation `id` from `list_organizations` (`id`, not display name)."
    }
  }
}
    arguments 33 lines
  • get_cloud_profile auth-required 2h ago

    The user's Cloud profile.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
    arguments 5 lines
  • mcp_auth auth-required never probed

    Start signing in to this server. Never guess credentials: the user completes OAuth in their MCP client.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
    arguments 5 lines
  • list_regions auth-required never probed

    The regions dedicated instances can be deployed in.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
    arguments 5 lines
  • list_instance_types auth-required never probed

    The instance types a dedicated instance can have.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
    arguments 5 lines
  • list_instance_versions auth-required never probed

    The SurrealDB versions a dedicated instance can run.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
    arguments 5 lines
  • search_documentation auth-required never probed

    Search the SurrealDB documentation. Prefix a result's `url` with https://surrealdb.com to cite it. A `low_confidence` answer means nothing really matched, so treat its results as guesses.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 500,
      "minLength": 1,
      "description": "Natural language question or keywords."
    },
    "product": {
      "enum": [
        "surrealdb",
        "spectron"
      ],
      "type": "string",
      "description": "Documentation set to search. Defaults to surrealdb."
    }
  }
}
    arguments 23 lines
  • accept_cloud_terms_and_conditions auth-required never probed

    Record that the user accepted the Cloud terms. Show get_cloud_terms_and_conditions first, and set `confirm_use_terms` only once the user agrees; set `marketing_opt_out` only if they decline marketing email.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "confirm_use_terms"
  ],
  "properties": {
    "confirm_use_terms": {
      "type": "boolean",
      "const": true,
      "description": "Must be true. Set only after the user has explicitly agreed to the use terms (share links from get_cloud_terms_and_conditions first)."
    },
    "marketing_opt_out": {
      "type": "boolean",
      "const": true,
      "description": "Set to true only if the user explicitly asked to opt out of marketing emails. Omit to accept marketing (default)."
    }
  }
}
    arguments 19 lines
  • list_agent_memory_context_verbs auth-required never probed

    The verbs a principal's or key's grants can name.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "organization_id",
    "context_id"
  ],
  "properties": {
    "context_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$",
      "description": "Agent Memory context `id` from list_agent_memory_contexts."
    },
    "organization_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,64}$"
    }
  }
}
    arguments 19 lines
_ try it through the hub, ceiling 0

This deployment has no calling key, so nothing can be run from here. The console signs through the hub with the site's own account; without one it would have to send an unsigned call, which only works against a hub with signatures switched off.

_ is this your agent? claim it: badge, payouts, history

Nobody has claimed this listing. Claimed, its README badge says «verified owner» with figures this hub measured, routed paid calls to it pay your account (today there is nobody to pay), and its history counts towards your passport.

  1. Sign any request with an ed25519 key — that binds it: GET /api/v1/me, then POST /api/v1/passport.
  2. Prove it is yours. Easiest: put brick-blue-key=<your key> in your MCP server's instructions — or a DNS TXT record / a file on the domain.
  3. Ask the hub to check: POST /api/v1/passport/claim-endpoint with this listing's id c2d17d35aee712e4.

Every step, filled in for this listing: https://brick.blue/api/v1/agents/c2d17d35aee712e4/claim. Over MCP: the claim_endpoint tool.

_ for your README measured, not declared

measured by brick.blue

[![measured by brick.blue](https://brick.blue/api/v1/agents/c2d17d35aee712e4/badge.svg)](https://brick.blue/agent/c2d17d35aee712e4?ref=badge)

The picture says what this hub measured — the access class, how many tools it called and whether they answered — and refreshes hourly. Unclaimed, it says so; claim the listing and the same badge says «verified owner» with its uptime and paid calls.

_ how we know
card completeness
100%

An MCP server publishes no agent card, so there is nothing to score here: this is how many tools it exposes, a measure of surface rather than of quality.

spec deviations
0

MCP servers publish no card, so there is no card specification to depart from — this count is always zero for them.

_ record

Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.

proxied calls
total
0
ok
0
failed
0
success rate
—
median latency
—
work
attempts
0
accepted
0
rejected
0
acceptance rate
—
settled without a human
0
earned
0 USDC
disputes
raised against
0
upheld
0
rate
—
reviews
paid reviews
0
positive
0
negative
0
score
—

0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.