# Kaleido — how to use (mcp.ai)

Connect your Kaleido account and use 29 tools for developer tools straight from your AI agent. Connect with your own API key. Kaleido is a full-stack platform for building and managing enterprise blockchain networks and applications.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_kaleido?ms=1787293440000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `kaleido_add_identity_proof`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/kaleido`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/kaleido/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/kaleido/add/identity/proof` — Add an x509 identity proof to a Kaleido organization. Use this to register a certificate chain that links an organization's off-chain PKI identity to their blockchain accounts. The certificate will be
  - body: { name: string, type?: string, org_id: string, payload: string }
- `POST https://api.mcp.ai/api/kaleido/create/api/key` — Creates a new API key for the specified Kaleido organization. The returned apikey secret should be stored securely as it cannot be retrieved again. Use KALEIDO_GET_ORGANIZATIONS to obtain a valid org_
  - body: { name?: string, org_id: string }
- `POST https://api.mcp.ai/api/kaleido/delete/api/key` — Permanently deletes an API key by its ID. First use 'Get API Keys' to retrieve the list of API keys and their IDs. The deletion is irreversible.
  - body: { apikey_id: string }
- `POST https://api.mcp.ai/api/kaleido/delete/organization/identity/proof` — Remove an x509 identity proof from a Kaleido organization. This permanently deletes the identity proof. The deletion is irreversible.
  - body: { org_id: string, proof_id: string }
- `POST https://api.mcp.ai/api/kaleido/get/api/key` — Tool to retrieve details of a specific API key by its ID. Use when you need to get information about a particular API key after obtaining its ID from the Get API Keys action.
  - body: { apikey_id: string }
- `POST https://api.mcp.ai/api/kaleido/get/api/keys` — Tool to retrieve all API keys associated with the organization. Use when you need an overview of existing API keys after authenticating.
- `POST https://api.mcp.ai/api/kaleido/get/application/credentials` — Tool to retrieve application credentials for a specific environment. Use when you need to list DApp credentials after environment setup.
  - body: { consortia_id: string, environment_id: string }
- `POST https://api.mcp.ai/api/kaleido/get/billing/summary` — Retrieves a summary of billing data for the specified organization for the current month. Use this to view costs breakdown by memberships, nodes, services, storage, and support.
  - body: { year?: string, month?: string, org_id: string }
- `POST https://api.mcp.ai/api/kaleido/get/consortia` — Tool to retrieve all consortia associated with the organization. Use after authenticating to view existing consortia.
  - body: { skip?: integer, limit?: integer }
- `POST https://api.mcp.ai/api/kaleido/get/event/streams` — List all event streams configured on a Kaleido blockchain node's Ethconnect REST API Gateway. Event streams provide at-least-once delivery of Ethereum events from your blockchain node to webhook endpo
  - body: { node_id?: string, full_url?: string, zone_domain?: string, environment_id?: string }
- `POST https://api.mcp.ai/api/kaleido/get/identity/proof` — Tool to retrieve a specific identity proof for a Kaleido organization. Use when you need details about a specific x509 certificate or identity proof that was previously added to an organization.
  - body: { org_id: string, proof_id: string }
- `POST https://api.mcp.ai/api/kaleido/get/invitations` — Tool to retrieve all invitations for the current user where they are the target. Use after authenticating to view pending invitations.
- `POST https://api.mcp.ai/api/kaleido/get/memberships` — Tool to retrieve all memberships for the current user. Use after authenticating to list user memberships.
  - body: { query?: string }
- `POST https://api.mcp.ai/api/kaleido/get/org/billing/provider` — Retrieves billing provider information for a specific organization in Kaleido. Returns the type of billing provider (AWS, Stripe, or other) and includes detailed payment information if the organizatio
  - body: { org_id: string }
- `POST https://api.mcp.ai/api/kaleido/get/organization` — Tool to retrieve details of a specific Kaleido organization by its ID. Use when you need to fetch information about a particular organization.
  - body: { org_id: string }
- `POST https://api.mcp.ai/api/kaleido/get/organization/plan` — Retrieve the subscription plan details for a Kaleido organization. Returns plan name, waitlist status, and resource limits including allowed providers, nodes, services, configurations, and features. U
  - body: { org_id: string }
- `POST https://api.mcp.ai/api/kaleido/get/organizations` — Retrieves all organizations that the authenticated user has access to in Kaleido. Returns organization details including: - Organization ID, name, and type - Subscription plan and billing information 
- `POST https://api.mcp.ai/api/kaleido/get/plans` — Retrieve all available Kaleido subscription plans. Returns plan details including enabled status, tier level, and resource limits. Use this to discover available plans before creating or upgrading env
- `POST https://api.mcp.ai/api/kaleido/get/regions` — Retrieve all available Kaleido deployment regions and their deployment zones. Returns a dictionary of regions (keyed by region code like 'u0', 'e0', 'a0', 'k0', 'u1', 'e1') with each region containing
- `POST https://api.mcp.ai/api/kaleido/get/releases` — Retrieve all available blockchain node software releases from the Kaleido platform. Use this tool to: - List all runtime releases available for different blockchain providers (quorum, geth, besu, cord
- `POST https://api.mcp.ai/api/kaleido/get/role/by/id` — Retrieve a specific user role assignment within a Kaleido organization. Returns detailed information about the role including user ID, email, role name (e.g., 'admin'), and associated metadata. Use GE
  - body: { org_id: string, role_id: string }
- `POST https://api.mcp.ai/api/kaleido/get/roles` — Retrieve all user role assignments for a Kaleido organization. Returns each user's role (e.g., 'admin'), email, and associated metadata. Use GET_ORGANIZATIONS first to obtain valid org_id values.
  - body: { org_id: string }
- `POST https://api.mcp.ai/api/kaleido/get/services` — Tool to retrieve all services the current user owns or can see. Use after authenticating to list available services.
- `POST https://api.mcp.ai/api/kaleido/get/token/factory/tokens` — Retrieves all token contracts from a Kaleido Token Factory service. The Token Factory service enables deployment of ERC20 (fungible) and ERC721 (non-fungible) token contracts. This action lists all to
  - body: { service_api_base_url?: string }
- `POST https://api.mcp.ai/api/kaleido/get/wallet/account/nonce` — Retrieve the current nonce (transaction count) of a specific HD wallet account. The nonce is essential for signing Ethereum transactions - it ensures transactions are processed in order and prevents r
  - body: { wallet_id: string, account_index: integer, service_api_base_url: string }
- `POST https://api.mcp.ai/api/kaleido/get/wallets` — Tool to retrieve HD wallet IDs hosted in the service. Use after creating or importing HD wallets to enumerate available wallets.
  - body: { service_api_base_url?: string }
- `POST https://api.mcp.ai/api/kaleido/update/org/role` — Update the role assignment for a user in a Kaleido organization. Use this to change a user's permissions level (e.g., promoting to admin). Returns the updated role details including the new revision t
  - body: { role: string, org_id: string, role_id: string }
- `POST https://api.mcp.ai/api/kaleido/update/organization` — Tool to update a specific organization in Kaleido. Use when you need to modify organization properties such as name, billing details, or authentication settings. First obtain the org_id using the Get 
  - body: { name?: string, plan?: string, org_id: string, plan_id?: string, delegate?: string, trial_ends?: string, waitlisted?: boolean, support_level?: integer, cognito_domain?: string, cognito_region?: string, terms_accepted?: integer, billing_account?: object, cognito_client_id?: string, cognito_user_pool_id?: string, cognito_client_secret?: string }
- `POST https://api.mcp.ai/api/kaleido/upsert/organization/role` — Upsert (create or update) a role assignment for a user in a Kaleido organization. Returns 201 for new roles and 200 for updates. The _revision field increments with each update. Use GET_ORGANIZATIONS 
  - body: { role: string, org_id: string, role_id: string, user_id: string }

## Example prompts
- "What can I do in Kaleido?"
- "Show me a summary of my Kaleido account"

## More
- Page: https://mcp.ai/kaleido
- Agent spec (llms.txt): https://mcp.ai/kaleido/llms.txt
- Postman collection: https://mcp.ai/kaleido/postman.json