MCP
Available tools
Every MCP tool the @loomal/mcp server exposes, grouped by capability
The Loomal MCP server (@loomal/mcp) exposes the Loomal project surface as a set of MCP tools your agent can call directly — no SDK install needed. See MCP setup for how to wire it into Claude Desktop, Cursor, VS Code, or any MCP client.
Tool names follow <capability>.<action> so they're easy to scan in a tool picker.
Identity
| Tool | What it does |
|---|---|
identity.whoami | Get the project identity (name, email, scopes, DID) |
identity.sign | Sign data as the agent's Ed25519 DID key |
identity.verify | Verify a signature against any did:web identity |
| Tool | What it does |
|---|---|
mail.send | Send a message |
mail.reply | Reply on the same thread |
mail.list_messages | List inbox messages, filter by labels |
mail.get_message | Read a single message by ID |
mail.get_attachment | Download an attachment |
mail.update_labels | Add or remove labels on a message |
mail.update_thread_labels | Add or remove labels on a thread |
mail.delete_message | Delete a message |
mail.list_threads | List conversations |
mail.get_thread | Get a full thread |
mail.delete_thread | Delete a thread |
Vault
| Tool | What it does |
|---|---|
vault.list | List stored credentials |
vault.get | Get a decrypted credential |
vault.store | Store a credential |
vault.delete | Delete a credential |
vault.totp | Generate a current TOTP code |
vault.totp_use_backup | Consume a single-use TOTP backup code |
Calendar
| Tool | What it does |
|---|---|
calendar.create | Create an event |
calendar.update | Update an event |
calendar.list | List events, filter by date range |
calendar.get | Get event details |
calendar.delete | Delete an event |
calendar.set_public | Publish your calendar as ICS |
Payments
Buyer-side x402 — pay any priced URL, manage spend mandates, query activity. The payments_* tools (except payments_activity) require the payments:spend scope.
| Tool | What it does |
|---|---|
payments.pay | Pay an x402-priced URL within the active mandate |
payments.activity | Bank-statement-style merged feed of payments sent and received |
payments.mandates_create | Create the spend policy on this identity's wallet |
payments.mandates_list | List mandates |
payments.mandates_get | Fetch one mandate with live spend counters |
payments.mandates_revoke | Revoke a mandate |
Platform (admin)
These tools require a platform key (lopk-...) — see Multi-identity. They manage projects at the org level.
| Tool | What it does |
|---|---|
platform.list | List all projects in the org |
platform.get | Get project details |
platform.create | Provision a new project |
platform.delete | Delete a project |
platform.rotate-key | Rotate a project's API key |
platform.update-scopes | Update project scopes |