Every tool a connected agent gets on the Sumvin MCP connector, grouped by what it’s for.
A connected agent doesn’t see everything Sumvin can do. It sees a fixed set of tools, chosen for the
account holder’s own errands and identity — never budgets, card controls, or anything that isn’t the
agent’s to touch. The account holder manages those in the Sumvin app or the CLI instead.These tools are visible before an account is connected, so a client can list them as soon as the
connector is added. Each tool declares the OAuth scope it needs, and a client uses that to ask the
person to connect their Sumvin account the first time a tool needs it. Calling a tool before then
returns a refusal that asks the client to connect the account.Someone with no Sumvin account yet sees the same tools, but every one of them needs an account first.
Calling any of them returns a refusal that carries a sign-up link to hand to the person — see
Refusals.Each tool is either Read (returns information, changes nothing) or Write (starts or changes
something). Most tools work for anyone with an account; a few need the account holder’s identity to
be verified first — those are marked below.
Getting started
onboarding_status
ReadShow where the account holder has got to in setting up their account: which steps are done,
which are next, and how far the key they sign with has got. Reading it changes nothing.Each stage reads current (the one to do next), pending (still ahead), submitted (handed
in and waiting on a review), completed, or skipped (waived for this account). The identity
stage can also read retry: the reviewer asked for the ID capture again. The account holder
retakes it on the verification page they already have open, and their phone stays confirmed. If
that page is closed, call kyc_start for a fresh link.Or the identity stage can read rejected: the reviewer has made a final decision not to verify
the account holder. Trying again won’t change it, so your agent doesn’t call kyc_start for
them. It tells them plainly that their identity couldn’t be verified and points them to Sumvin
support. recorded_at is when the decision was made, and it stays final unless a reviewer later
approves them.Each stage also carries recorded_at: when it reached its status, in epoch milliseconds. It’s
null while the stage is open, or when no time was recorded.While the account holder still owes a signing key, the answer carries signing_key_url: the
browser page where they create and bind that key themselves. Your agent hands it to them to
open; there’s nothing it can call to bind the key on their behalf.
Try asking your agent: “Where am I up to with Sumvin?“
kyc_start
WriteGet the link that starts identity verification, and hand it to the account holder. It’s a single
browser trip: they verify a phone number, then their identity, in one sitting. If they’re already
verified, this says so instead of handing over a link.If the reviewer has made a final decision not to verify the account holder, the call is refused
with the code KYC-403-005 and no link is made. Starting again won’t change the decision, so your
agent tells them plainly and points them to Sumvin support instead of retrying.
Try asking your agent: “Help me get verified with Sumvin.”
Identity
sigil_show
ReadShow the account holder’s Sigil — their verified identity. Reports whether it’s been issued yet,
is being issued right now, or hasn’t started. Not having one yet is a normal answer, not a problem.
Try asking your agent: “Show me my Sigil.”
agent_identity_show
ReadShow this connection’s own identity: its registration status, and whether it’s linked to the
account holder’s Sigil yet. Answers only for the connection asking — it can’t see any other agent
the account holder has connected.
Try asking your agent: “What’s your identity under my Sigil?”
Stamped Mandates
A Stamped Mandate is a signed authorisation for what one agent may do. These tools cover the
spending kind — how much an agent may spend, and until when — because that’s what the mandate
tools support today. These tools still show their internal name, pint, in two places: it’s
the same object as a Stamped Mandate, and the rename is in progress.
mandate_request
Write · Needs verificationAsk the account holder to authorise spending, and get the link that lets them review and sign it.
This doesn’t grant anything by itself — only the account holder can sign, on their own page, and
an agent can’t do that for them. Needs a wallet and a verified identity first; if either is
missing, this says which one and where to go next.
Try asking your agent: “Set up a spending limit of $50 for groceries this week.”
mandate_status
ReadCheck what the account holder decided about a mandate that was requested: still waiting, signed,
declined, or expired. There’s no notification when they decide — call this again after giving them
time to look.
Try asking your agent: “Did I approve that spending limit yet?“
mandate_verify
ReadCheck a Stamped Mandate someone else has presented: what it permits, up to how much, and whether
it still stands. Use this before acting on a mandate a counterparty shows you — an identifier alone
proves nothing, and a mandate can be withdrawn at any time after it’s granted.
Try asking your agent: “Check whether this mandate is still valid before we go ahead.”
mandate_capacity_query
ReadRead what’s left to spend under the Stamped Mandate authorising an errand: its limit, what’s
settled, what’s held by spending in flight, and what remains.
Try asking your agent: “How much is left on the mandate for my grocery errand?“
pint_query
ReadList the Stamped Mandates issued to the account holder. Filter by status or by identifier.
Try asking your agent: “Show me all my active spending limits.”
pint_revoke
WritePermanently withdraw a Stamped Mandate. This can’t be undone — anything relying on it to spend
stops being able to, immediately. Find the one to revoke with pint_query first.
Try asking your agent: “Revoke the spending limit I set up for groceries.”
Payment methods
An errand pays with the card the account holder has added. These tools let an agent check that a
card is ready and, when it isn’t, send the account holder to the page where they add one. The card
is always entered on that page, by the account holder — never in the conversation.
payment_method_query
ReadList the cards the account holder has added and whether each is ready. A card can pay for an
errand only once it shows as verified. Card numbers are never shown — only the last four digits.
Try asking your agent: “Is my card ready for purchases?“
payment_method_add
ReadGet the link to the page where the account holder adds the card their errands pay with, along
with the cards they already have. The tool changes nothing itself. A card can be added once
identity verification has finished; wait for it to show as verified before starting an errand.
Try asking your agent: “I need to add a card before you buy anything for me.”
Errands
An errand is a long-running purchase task the account holder asked their agent to make, run within a Stamped Mandate.
errand_create
WriteStart a new errand from what the account holder asked for, in their own words, with the most
they’ll spend: constraints.max_total (whole purchase) or constraints.max_price (per item),
plus constraints.currency. Without a spend limit the errand isn’t created
(spend_limit_required). Starting an errand doesn’t authorise any spending on its own: the
account holder asks, signs, and only then does Sumvin search, check the merchant, watch for
their conditions, and settle the purchase.
Try asking your agent: “Reorder my usual coffee beans.”
errand_action
WriteAct on an errand that’s already running: answer a question it’s waiting on, or cancel it.
Signing an errand isn’t available here — only the account holder can sign it, before it
searches, on their own page. A pick found within the bounds they signed is then bought without
asking them again.
Try asking your agent: “Cancel that coffee order — I changed my mind.”
errand_query
ReadRead the account holder’s errands: what they are, and where each one stands. Filter by status or
by identifier.
Try asking your agent: “What’s the status of my coffee order?“
errand_events_query
ReadRead one errand’s history: what happened, and when, oldest first.
Try asking your agent: “What’s happened so far with my coffee order?”
Account
account_query
ReadRead the account holder’s linked accounts.
Try asking your agent: “What accounts do I have linked?“
wallet_query
ReadRead the account holder’s wallets.
Try asking your agent: “Show me my wallets.”
transaction_query
ReadRead the account holder’s transactions: what they spent, where, and when.When the agent presents a Stamped Mandate that signs transactions:read with a date range, the
results are held inside that range, whether or not the question names dates, and a date outside it
is refused. Signing in to the connector alone carries no date range. See
Limit reads to a date range.
Try asking your agent: “What have I spent this week?“
asset_query
ReadRead reference data for the currencies and assets Sumvin supports. Not scoped to the account
holder — this is general information, not a personal record.
Try asking your agent: “What currencies does Sumvin support?”
Server
server_info
Read · No account neededReport the build identity of the Sumvin server this connection has reached. Useful for confirming
the connection is live before trying anything else.
Try asking your agent: “Are you connected to Sumvin?“
sumvin_guide
Read · No account neededLoad a Sumvin guide: what Sumvin is, how to use its tools safely, and the reference file for each
task. Pass name (sumvin-sigil, or sumvin-sigil-onboard for someone without an account yet),
and file for one of its reference files. It’s the same content a host that supports skills
installs from skill://sumvin-sigil, so a host that only calls tools still gets it.
Try asking your agent: “How do you use Sumvin?”
In the Sumvin app and CLI
These tools answer only when the account holder’s own Sumvin app or the Sumvin CLI calls the
server. A connected agent never sees them: calling one from a connector is refused, and the refusal
says to manage it in the app or the CLI instead.
allocations_query
ReadList what has been spent against an errand’s mandate, newest first, and whether each spend has
settled.
budget_query
ReadRead the account holder’s budgets, by name, type, or the kind of spending they cover.
budget_upsert
WriteCreate a budget, or replace one in full.
budget_delete
WriteDelete a budget. It stops counting spending; its history is kept.
card_query
ReadRead the account holder’s cards and their current status.
card_action
WriteFreeze a card, or unfreeze it. Neither cancels the card or touches payments already made.
rule_query
ReadRead the account holder’s rules.
rule_upsert
WriteCreate a rule, or replace one in full.
rule_delete
WriteDelete a rule. It stops applying from then on.
strategy_list
ReadList the strategies the account holder can enrol in.
user_strategy_query
ReadRead the strategies the account holder is enrolled in.
user_strategy_create
WriteEnrol the account holder in a strategy, after checking that whatever it needs is in place.
user_strategy_update
WritePause or restart an enrolment, or adjust its settings.
user_agent_task_query
ReadRead the runs queued or completed for the account holder’s strategies.
user_agent_task_manage
WriteQueue a strategy run, or cancel one that hasn’t started.
wallet_update
WriteRename a wallet, or make it the account holder’s main one.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Sumvin","description":"Identity for every agent. Give your agent a verified identity, set the limits it acts within, and let it run errands for you.","colors":{"primary":"#1A6B3C","light":"#8BC540","dark":"#1A6B3C"},"logo":{"light":"https://mintcdn.com/sumvin/iFVoZsDR9WS3r7Vw/logo/light.svg?fit=max\u0026auto=format\u0026n=iFVoZsDR9WS3r7Vw\u0026q=85\u0026s=94c21eea5f2b742115618f128bafa28b","dark":"https://mintcdn.com/sumvin/iFVoZsDR9WS3r7Vw/logo/dark.svg?fit=max\u0026auto=format\u0026n=iFVoZsDR9WS3r7Vw\u0026q=85\u0026s=6cdf55e6a87e956d6d7fca6f5b65caa3","href":"/"},"favicon":"https://mintcdn.com/sumvin/iFVoZsDR9WS3r7Vw/favicon.svg?fit=max\u0026auto=format\u0026n=iFVoZsDR9WS3r7Vw\u0026q=85\u0026s=414a08a95872d9ecf8eaf56bf5176cc9","appearance":{"default":"light","strict":false},"background":{"color":{"light":"#F5F2EE","dark":"#0E1116"}},"navbar":{"primary":{"type":"button","label":"Connect your agent","href":"/get-started/connect"}},"seo":{"metatags":{"og:site_name":"Sumvin Docs","og:type":"website","twitter:card":"summary_large_image"},"indexing":"navigable"},"fonts":{"heading":{"family":"Playfair Display","weight":500},"body":{"family":"DM Sans","weight":400}},"icons":{"library":"lucide"},"styling":{"eyebrows":"section","codeblocks":{"theme":{"light":"vitesse-light","dark":"vitesse-dark"}},"latex":true},"contextual":{"options":["copy","view","claude","chatgpt","cursor","vscode","mcp","add-mcp"],"display":"header"},"navigation":{"global":{"anchors":[{"anchor":"Changelog","icon":"history","href":"/changelog"},{"anchor":"Get help","icon":"life-buoy","href":"mailto:hello@sumvin.com"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"sumvin","hasAudioNarration":false,"actualSubdomain":"sumvin","customDomains":["docs.sumvin.com"],"gitSource":{"type":"github","owner":"sibylline-advisory","repo":"sumvin-api","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6acf382b2e3d8da06f635a9a","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Concepts","count":16},{"language":"default","tag":"SDK","count":14},{"language":"default","tag":"Reference","count":13},{"language":"default","tag":"Get started","count":12},{"language":"default","tag":"Stamped Mandates","count":7},{"language":"default","tag":"CLI","count":7},{"language":"default","tag":"Guides","count":6},{"language":"default","tag":"The nouns","count":5},{"language":"default","tag":"Everyday","count":5},{"language":"default","tag":"Check a mandate","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":"/* cyrillic-ext */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx3cwhsk.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxTcwhsk.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* greek */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxPcwhsk.woff2) format('woff2');\n unicode-range: U+0370-0377, U+037A-037F, U+0384-038A, U+038C, U+038E-03A1, U+03A3-03FF;\n}\n/* vietnamese */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx_cwhsk.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx7cwhsk.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxDcwg.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* cyrillic-ext */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx3cwhsk.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxTcwhsk.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* greek */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxPcwhsk.woff2) format('woff2');\n unicode-range: U+0370-0377, U+037A-037F, U+0384-038A, U+038C, U+038E-03A1, U+03A3-03FF;\n}\n/* vietnamese */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx_cwhsk.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx7cwhsk.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxDcwg.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n:root{--gray-50: 245 242 238;--gray-100: 238 235 230;--gray-200: 225 221 214;--gray-300: 204 199 192;--gray-400: 158 154 148;--gray-500: 112 111 110;--gray-600: 80 82 87;--gray-700: 58 62 70;--gray-800: 36 40 48;--gray-900: 23 27 34;--gray-950: 14 17 22;--sv-ground: #f5f2ee;--sv-ink: #0a0a0a;--sv-muted: rgb(10 10 10 / 0.65);--sv-surface: #f0ede8;--sv-border: rgb(10 10 10 / 0.08);--sv-lime: #8bc540;--sv-forest: #1a6b3c;--sv-teal: #0d2e2b;--sv-danger: #e5412d;--sv-mono: \"JetBrains Mono\", ui-monospace, \"SFMono-Regular\", monospace;--sv-radius: 10px;--sv-radius-xl: 14px;--sv-radius-pill: 9999px;--sv-ease: cubic-bezier(0.16, 1, 0.3, 1)}.dark{--sv-ground: #0e1116;--sv-ink: #f5f2ee;--sv-muted: rgb(245 242 238 / 0.65);--sv-surface: #171b22;--sv-border: rgb(245 242 238 / 0.1);--sv-danger: #f97b73}code,pre,code-block,eyebrow{font-family:var(--sv-mono)}eyebrow{text-transform:uppercase;letter-spacing:0.08em;font-size:0.72rem;font-weight:500}#page-title,#content-area h1,#content-area h2,#content-area h3{font-weight:500;letter-spacing:-0.02em}#content-area h3{letter-spacing:-0.01em}mdx-content table,code{font-variant-numeric:tabular-nums}#navbar{background:color-mix(in oklch, var(--sv-ground) 82%, transparent);backdrop-filter:blur(12px);-webkit-backdrop-filter:blur(12px);border-bottom:1px solid var(--sv-border)}.nav-tabs-item[data-active]{color:var(--sv-ink)}html,body{background-color:var(--sv-ground)}#sidebar-content li[data-active]{font-weight:600}toc-item[data-active-deepest]{font-weight:600}#topbar-cta-button a>span:first-child{background:var(--sv-lime);border-radius:var(--sv-radius-pill);transition:background-color 0.3s var(--sv-ease)}#topbar-cta-button a,#topbar-cta-button a *{color:#0a0a0a}#topbar-cta-button a:hover>span:first-child{background:#0a0a0a;opacity:1}#topbar-cta-button a:hover,#topbar-cta-button a:hover *{color:var(--sv-lime)}card{border-radius:var(--sv-radius-xl);border-color:var(--sv-border);box-shadow:inset 0 1px 0 0 rgb(255 255 255 / 0.04);transition:border-color 0.4s var(--sv-ease)}card:hover{border-color:color-mix(in oklch, var(--sv-lime) 55%, transparent)}callout,[data-callout-type]{border-radius:var(--sv-radius)}[data-callout-type=\"note\"]{background:var(--sv-surface);border-color:var(--sv-border);border-left:3px solid var(--sv-forest)}[data-callout-type=\"note\"],[data-callout-type=\"note\"] *{color:var(--sv-ink)}[data-callout-type=\"note\"] [data-component-part=\"callout-icon\"]{color:var(--sv-forest)}.dark [data-callout-type=\"note\"]{border-left-color:var(--sv-lime)}.dark [data-callout-type=\"note\"] [data-component-part=\"callout-icon\"]{color:var(--sv-lime)}code-block,code-group{border-radius:var(--sv-radius)}a:focus-visible,button:focus-visible,card:focus-visible,[tabindex]:focus-visible{outline:2px solid var(--sv-lime);outline-offset:2px}.sv-page{color:var(--sv-ink)}.sv-hero{background:var(--sv-teal);color:#f5f2ee}.sv-wrap{max-width:72rem;margin:0 auto;padding-left:clamp(1.25rem, 4vw, 3rem);padding-right:clamp(1.25rem, 4vw, 3rem)}.sv-eyebrow{font-family:var(--sv-mono);font-weight:500;text-transform:uppercase;letter-spacing:0.14em;font-size:0.75rem}.sv-hero .sv-eyebrow{color:var(--sv-lime)}.sv-display{font-family:\"Playfair Display\", ui-serif, Georgia, serif;font-weight:500;font-size:clamp(2.75rem, 1.6rem + 4.6vw, 5.25rem);line-height:1.04;letter-spacing:-0.03em;max-width:14ch;margin:0}.sv-lede{font-size:clamp(1.05rem, 0.95rem + 0.4vw, 1.25rem);line-height:1.55;max-width:38rem;color:rgb(245 242 238 / 0.78)}.sv-muted{color:var(--sv-muted)}.sv-doors{display:grid;grid-template-columns:repeat(auto-fit, minmax(17rem, 1fr));gap:1rem;max-width:46rem}.sv-door{display:flex;flex-direction:column;gap:0.35rem;padding:1.25rem 1.4rem;border-radius:var(--sv-radius-xl);border:1px solid rgb(245 242 238 / 0.18);color:#f5f2ee;text-decoration:none;transition:background-color 0.3s var(--sv-ease), color 0.3s var(--sv-ease),\n border-color 0.3s var(--sv-ease)}.sv-door:hover{border-color:rgb(245 242 238 / 0.45)}.sv-door--primary{background:var(--sv-lime);border-color:var(--sv-lime);color:#0a0a0a}.sv-door--primary:hover{background:#0a0a0a;border-color:#0a0a0a;color:var(--sv-lime)}.sv-door-title{font-weight:600;font-size:1.05rem}.sv-door-meta{font-family:var(--sv-mono);font-size:0.78rem;opacity:0.8}.sv-journey{list-style:none;margin:0;padding:0;display:grid;grid-template-columns:repeat(auto-fit, minmax(10.5rem, 1fr));border-top:1px solid var(--sv-border)}.sv-station{padding:1.25rem 1.25rem 1.5rem 0}.sv-station a{display:flex;flex-direction:column;gap:0.4rem;color:var(--sv-ink);text-decoration:none}.sv-station-num{font-family:var(--sv-mono);font-size:0.75rem;letter-spacing:0.08em;color:var(--sv-muted)}.sv-station-name{font-family:\"Playfair Display\", ui-serif, Georgia, serif;font-size:1.5rem;font-weight:500;line-height:1.2}.sv-station a:hover .sv-station-name{text-decoration:underline;text-decoration-color:var(--sv-lime);text-decoration-thickness:2px;text-underline-offset:6px}.sv-station-copy{font-size:0.925rem;line-height:1.5;color:var(--sv-muted);max-width:22ch}.sv-rule{border-top:1px solid var(--sv-border)}.sv-partners{display:flex;flex-wrap:wrap;gap:0.75rem 2.5rem;align-items:baseline}.sv-partner{color:var(--sv-ink);text-decoration:none;font-family:\"Playfair Display\", ui-serif, Georgia, serif;font-size:1.35rem;font-weight:500}.sv-partner:hover{text-decoration:underline;text-decoration-color:var(--sv-lime);text-underline-offset:5px}.sv-partner-role{display:block;font-family:var(--sv-mono);font-size:0.72rem;letter-spacing:0.06em;text-transform:uppercase;color:var(--sv-muted)}.sv-agent-line code{font-size:0.9em}.sv-agent-line a{color:var(--sv-ink);text-decoration-color:var(--sv-lime);text-underline-offset:4px}@keyframes sv-in{from{opacity:0;transform:translateY(8px) scale(0.98)}to{opacity:1;transform:none}}.sv-enter{animation:sv-in 0.5s var(--sv-ease) both}.sv-enter-2{animation:sv-in 0.5s var(--sv-ease) 90ms both}.sv-enter-3{animation:sv-in 0.5s var(--sv-ease) 180ms both}@media (prefers-reduced-motion: reduce){.sv-enter,.sv-enter-2,.sv-enter-3{animation:none}card,.sv-door{transition:none}}"}]}
{"page":{"pagePath":"reference/mcp/tools","slug":"/reference/mcp/tools","pageMetadata":{"title":"MCP tools","description":"Every tool a connected agent gets on the Sumvin MCP connector, grouped by what it's for.","icon":"wrench","href":"/reference/mcp/tools"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Every tool a connected agent gets on the Sumvin MCP connector, grouped by what it’s for.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Badge,Heading,Tip}=_components;if(!Badge)_missingMdxReference(`Badge`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`A connected agent doesn’t see everything Sumvin can do. It sees a fixed set of tools, chosen for the\naccount holder’s own errands and identity — never budgets, card controls, or anything that isn’t the\nagent’s to touch. The account holder manages those in the Sumvin app or the CLI instead.`}),`\n`,_jsx(_components.p,{children:`These tools are visible before an account is connected, so a client can list them as soon as the\nconnector is added. Each tool declares the OAuth scope it needs, and a client uses that to ask the\nperson to connect their Sumvin account the first time a tool needs it. Calling a tool before then\nreturns a refusal that asks the client to connect the account.`}),`\n`,_jsxs(_components.p,{children:[`Someone with no Sumvin account yet sees the same tools, but every one of them needs an account first.\nCalling any of them returns a refusal that carries a sign-up link to hand to the person — see\n`,_jsx(_components.a,{href:`/reference/mcp/refusals`,children:`Refusals`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Each tool is either `,_jsx(_components.strong,{children:`Read`}),` (returns information, changes nothing) or `,_jsx(_components.strong,{children:`Write`}),` (starts or changes\nsomething). Most tools work for anyone with an account; a few need the account holder’s identity to\nbe verified first — those are marked below.`]}),`\n`,_jsx(Heading,{level:`2`,id:`getting-started`,children:`Getting started`}),`\n`,_jsx(Heading,{level:`3`,id:`onboarding_status`,children:`onboarding_status`}),`\n`,_jsx(Badge,{children:`Read`}),`\n`,_jsx(_components.p,{children:`Show where the account holder has got to in setting up their account: which steps are done,\nwhich are next, and how far the key they sign with has got. Reading it changes nothing.`}),`\n`,_jsxs(_components.p,{children:[`Each stage reads `,_jsx(_components.code,{children:`current`}),` (the one to do next), `,_jsx(_components.code,{children:`pending`}),` (still ahead), `,_jsx(_components.code,{children:`submitted`}),` (handed\nin and waiting on a review), `,_jsx(_components.code,{children:`completed`}),`, or `,_jsx(_components.code,{children:`skipped`}),` (waived for this account). The identity\nstage can also read `,_jsx(_components.code,{children:`retry`}),`: the reviewer asked for the ID capture again. The account holder\nretakes it on the verification page they already have open, and their phone stays confirmed. If\nthat page is closed, call `,_jsx(_components.code,{children:`kyc_start`}),` for a fresh link.`]}),`\n`,_jsxs(_components.p,{children:[`Or the identity stage can read `,_jsx(_components.code,{children:`rejected`}),`: the reviewer has made a final decision not to verify\nthe account holder. Trying again won’t change it, so your agent doesn’t call `,_jsx(_components.code,{children:`kyc_start`}),` for\nthem. It tells them plainly that their identity couldn’t be verified and points them to Sumvin\nsupport. `,_jsx(_components.code,{children:`recorded_at`}),` is when the decision was made, and it stays final unless a reviewer later\napproves them.`]}),`\n`,_jsxs(_components.p,{children:[`Each stage also carries `,_jsx(_components.code,{children:`recorded_at`}),`: when it reached its status, in epoch milliseconds. It’s\nnull while the stage is open, or when no time was recorded.`]}),`\n`,_jsxs(_components.p,{children:[`While the account holder still owes a signing key, the answer carries `,_jsx(_components.code,{children:`signing_key_url`}),`: the\nbrowser page where they create and bind that key themselves. Your agent hands it to them to\nopen; there’s nothing it can call to bind the key on their behalf.`]}),`\n`,_jsxs(Tip,{children:[_jsx(_components.strong,{children:`Try asking your agent:`}),` “Where am I up to with Sumvin?“`]}),`\n`,_jsx(Heading,{level:`3`,id:`kyc_start`,children:`kyc_start`}),`\n`,_jsx(Badge,{children:`Write`}),`\n`,_jsx(_components.p,{children:`Get the link that starts identity verification, and hand it to the account holder. It’s a single\nbrowser trip: they verify a phone number, then their identity, in one sitting. If they’re already\nverified, this says so instead of handing over a link.`}),`\n`,_jsxs(_components.p,{children:[`If the reviewer has made a final decision not to verify the account holder, the call is refused\nwith the code `,_jsx(_components.code,{children:`KYC-403-005`}),` and no link is made. Starting again won’t change the decision, so your\nagent tells them plainly and points them to Sumvin support instead of retrying.`]}),`\n`,_jsxs(Tip,{children:[_jsx(_components.strong,{children:`Try asking your agent:`}),` “Help me get verified with Sumvin.”`]}),`\n`,_jsx(Heading,{level:`2`,id:`identity`,children:`Identity`}),`\n`,_jsx(Heading,{level:`3`,id:`sigil_show`,children:`sigil_show`}),`\n`,_jsx(Badge,{children:`Read`}),`\n`,_jsx(_components.p,{children:`Show the account holder’s Sigil — their verified identity. Reports whether it’s been issued yet,\nis being issued right now, or hasn’t started. Not having one yet is a normal answer, not a problem.`}),`\n`,_jsxs(Tip,{children:[_jsx(_components.strong,{children:`Try asking your agent:`}),` “Show me my Sigil.”`]}),`\n`,_jsx(Heading,{level:`3`,id:`agent_identity_show`,children:`agent_identity_show`}),`\n`,_jsx(Badge,{children:`Read`}),`\n`,_jsx(_components.p,{children:`Show this connection’s own identity: its registration status, and whether it’s linked to the\naccount holder’s Sigil yet. Answers only for the connection asking — it can’t see any other agent\nthe account holder has connected.`}),`\n`,_jsxs(Tip,{children:[_jsx(_components.strong,{children:`Try asking your agent:`}),` “What’s your identity under my Sigil?”`]}),`\n`,_jsx(Heading,{level:`2`,id:`stamped-mandates`,children:`Stamped Mandates`}),`\n`,_jsxs(_components.p,{children:[`A Stamped Mandate is a signed authorisation for what one agent may do. These tools cover the\nspending kind — how much an agent may spend, and until when — because that’s what the mandate\ntools support today. These tools still show their internal name, `,_jsx(_components.code,{children:`pint`}),`, in two places: it’s\nthe same object as a Stamped Mandate, and the rename is in progress.`]}),`\n`,_jsx(Heading,{level:`3`,id:`mandate_request`,children:`mandate_request`}),`\n`,_jsxs(_components.p,{children:[_jsx(Badge,{children:`Write`}),` · Needs verification`]}),`\n`,_jsx(_components.p,{children:`Ask the account holder to authorise spending, and get the link that lets them review and sign it.\nThis doesn’t grant anything by itself — only the account holder can sign, on their own page, and\nan agent can’t do that for them. Needs a wallet and a verified identity first; if either is\nmissing, this says which one and where to go next.`}),`\n`,_jsxs(Tip,{children:[_jsx(_components.strong,{children:`Try asking your agent:`}),` “Set up a spending limit of $50 for groceries this week.”`]}),`\n`,_jsx(Heading,{level:`3`,id:`mandate_status`,children:`mandate_status`}),`\n`,_jsx(Badge,{children:`Read`}),`\n`,_jsx(_components.p,{children:`Check what the account holder decided about a mandate that was requested: still waiting, signed,\ndeclined, or expired. There’s no notification when they decide — call this again after giving them\ntime to look.`}),`\n`,_jsxs(Tip,{children:[_jsx(_components.strong,{children:`Try asking your agent:`}),` “Did I approve that spending limit yet?“`]}),`\n`,_jsx(Heading,{level:`3`,id:`mandate_verify`,children:`mandate_verify`}),`\n`,_jsx(Badge,{children:`Read`}),`\n`,_jsx(_components.p,{children:`Check a Stamped Mandate someone else has presented: what it permits, up to how much, and whether\nit still stands. Use this before acting on a mandate a counterparty shows you — an identifier alone\nproves nothing, and a mandate can be withdrawn at any time after it’s granted.`}),`\n`,_jsxs(Tip,{children:[_jsx(_components.strong,{children:`Try asking your agent:`}),` “Check whether this mandate is still valid before we go ahead.”`]}),`\n`,_jsx(Heading,{level:`3`,id:`mandate_capacity_query`,children:`mandate_capacity_query`}),`\n`,_jsx(Badge,{children:`Read`}),`\n`,_jsx(_components.p,{children:`Read what’s left to spend under the Stamped Mandate authorising an errand: its limit, what’s\nsettled, what’s held by spending in flight, and what remains.`}),`\n`,_jsxs(Tip,{children:[_jsx(_components.strong,{children:`Try asking your agent:`}),` “How much is left on the mandate for my grocery errand?“`]}),`\n`,_jsx(Heading,{level:`3`,id:`pint_query`,children:`pint_query`}),`\n`,_jsx(Badge,{children:`Read`}),`\n`,_jsx(_components.p,{children:`List the Stamped Mandates issued to the account holder. Filter by status or by identifier.`}),`\n`,_jsxs(Tip,{children:[_jsx(_components.strong,{children:`Try asking your agent:`}),` “Show me all my active spending limits.”`]}),`\n`,_jsx(Heading,{level:`3`,id:`pint_revoke`,children:`pint_revoke`}),`\n`,_jsx(Badge,{children:`Write`}),`\n`,_jsxs(_components.p,{children:[`Permanently withdraw a Stamped Mandate. This can’t be undone — anything relying on it to spend\nstops being able to, immediately. Find the one to revoke with `,_jsx(_components.code,{children:`pint_query`}),` first.`]}),`\n`,_jsxs(Tip,{children:[_jsx(_components.strong,{children:`Try asking your agent:`}),` “Revoke the spending limit I set up for groceries.”`]}),`\n`,_jsx(Heading,{level:`2`,id:`payment-methods`,children:`Payment methods`}),`\n`,_jsx(_components.p,{children:`An errand pays with the card the account holder has added. These tools let an agent check that a\ncard is ready and, when it isn’t, send the account holder to the page where they add one. The card\nis always entered on that page, by the account holder — never in the conversation.`}),`\n`,_jsx(Heading,{level:`3`,id:`payment_method_query`,children:`payment_method_query`}),`\n`,_jsx(Badge,{children:`Read`}),`\n`,_jsx(_components.p,{children:`List the cards the account holder has added and whether each is ready. A card can pay for an\nerrand only once it shows as verified. Card numbers are never shown — only the last four digits.`}),`\n`,_jsxs(Tip,{children:[_jsx(_components.strong,{children:`Try asking your agent:`}),` “Is my card ready for purchases?“`]}),`\n`,_jsx(Heading,{level:`3`,id:`payment_method_add`,children:`payment_method_add`}),`\n`,_jsx(Badge,{children:`Read`}),`\n`,_jsx(_components.p,{children:`Get the link to the page where the account holder adds the card their errands pay with, along\nwith the cards they already have. The tool changes nothing itself. A card can be added once\nidentity verification has finished; wait for it to show as verified before starting an errand.`}),`\n`,_jsxs(Tip,{children:[_jsx(_components.strong,{children:`Try asking your agent:`}),` “I need to add a card before you buy anything for me.”`]}),`\n`,_jsx(Heading,{level:`2`,id:`errands`,children:`Errands`}),`\n`,_jsx(_components.p,{children:`An errand is a long-running purchase task the account holder asked their agent to make, run within a Stamped Mandate.`}),`\n`,_jsx(Heading,{level:`3`,id:`errand_create`,children:`errand_create`}),`\n`,_jsx(Badge,{children:`Write`}),`\n`,_jsxs(_components.p,{children:[`Start a new errand from what the account holder asked for, in their own words, with the most\nthey’ll spend: `,_jsx(_components.code,{children:`constraints.max_total`}),` (whole purchase) or `,_jsx(_components.code,{children:`constraints.max_price`}),` (per item),\nplus `,_jsx(_components.code,{children:`constraints.currency`}),`. Without a spend limit the errand isn’t created\n(`,_jsx(_components.code,{children:`spend_limit_required`}),`). Starting an errand doesn’t authorise any spending on its own: the\naccount holder asks, signs, and only then does Sumvin search, check the merchant, watch for\ntheir conditions, and settle the purchase.`]}),`\n`,_jsxs(Tip,{children:[_jsx(_components.strong,{children:`Try asking your agent:`}),` “Reorder my usual coffee beans.”`]}),`\n`,_jsx(Heading,{level:`3`,id:`errand_action`,children:`errand_action`}),`\n`,_jsx(Badge,{children:`Write`}),`\n`,_jsx(_components.p,{children:`Act on an errand that’s already running: answer a question it’s waiting on, or cancel it.\nSigning an errand isn’t available here — only the account holder can sign it, before it\nsearches, on their own page. A pick found within the bounds they signed is then bought without\nasking them again.`}),`\n`,_jsxs(Tip,{children:[_jsx(_components.strong,{children:`Try asking your agent:`}),` “Cancel that coffee order — I changed my mind.”`]}),`\n`,_jsx(Heading,{level:`3`,id:`errand_query`,children:`errand_query`}),`\n`,_jsx(Badge,{children:`Read`}),`\n`,_jsx(_components.p,{children:`Read the account holder’s errands: what they are, and where each one stands. Filter by status or\nby identifier.`}),`\n`,_jsxs(Tip,{children:[_jsx(_components.strong,{children:`Try asking your agent:`}),` “What’s the status of my coffee order?“`]}),`\n`,_jsx(Heading,{level:`3`,id:`errand_events_query`,children:`errand_events_query`}),`\n`,_jsx(Badge,{children:`Read`}),`\n`,_jsx(_components.p,{children:`Read one errand’s history: what happened, and when, oldest first.`}),`\n`,_jsxs(Tip,{children:[_jsx(_components.strong,{children:`Try asking your agent:`}),` “What’s happened so far with my coffee order?”`]}),`\n`,_jsx(Heading,{level:`2`,id:`account`,children:`Account`}),`\n`,_jsx(Heading,{level:`3`,id:`account_query`,children:`account_query`}),`\n`,_jsx(Badge,{children:`Read`}),`\n`,_jsx(_components.p,{children:`Read the account holder’s linked accounts.`}),`\n`,_jsxs(Tip,{children:[_jsx(_components.strong,{children:`Try asking your agent:`}),` “What accounts do I have linked?“`]}),`\n`,_jsx(Heading,{level:`3`,id:`wallet_query`,children:`wallet_query`}),`\n`,_jsx(Badge,{children:`Read`}),`\n`,_jsx(_components.p,{children:`Read the account holder’s wallets.`}),`\n`,_jsxs(Tip,{children:[_jsx(_components.strong,{children:`Try asking your agent:`}),` “Show me my wallets.”`]}),`\n`,_jsx(Heading,{level:`3`,id:`transaction_query`,children:`transaction_query`}),`\n`,_jsx(Badge,{children:`Read`}),`\n`,_jsx(_components.p,{children:`Read the account holder’s transactions: what they spent, where, and when.`}),`\n`,_jsxs(_components.p,{children:[`When the agent presents a Stamped Mandate that signs `,_jsx(_components.code,{children:`transactions:read`}),` with a date range, the\nresults are held inside that range, whether or not the question names dates, and a date outside it\nis refused. Signing in to the connector alone carries no date range. See\n`,_jsx(_components.a,{href:`/concepts/mandates/scopes#limit-reads-to-a-date-range`,children:`Limit reads to a date range`}),`.`]}),`\n`,_jsxs(Tip,{children:[_jsx(_components.strong,{children:`Try asking your agent:`}),` “What have I spent this week?“`]}),`\n`,_jsx(Heading,{level:`3`,id:`asset_query`,children:`asset_query`}),`\n`,_jsx(Badge,{children:`Read`}),`\n`,_jsx(_components.p,{children:`Read reference data for the currencies and assets Sumvin supports. Not scoped to the account\nholder — this is general information, not a personal record.`}),`\n`,_jsxs(Tip,{children:[_jsx(_components.strong,{children:`Try asking your agent:`}),` “What currencies does Sumvin support?”`]}),`\n`,_jsx(Heading,{level:`2`,id:`server`,children:`Server`}),`\n`,_jsx(Heading,{level:`3`,id:`server_info`,children:`server_info`}),`\n`,_jsxs(_components.p,{children:[_jsx(Badge,{children:`Read`}),` · No account needed`]}),`\n`,_jsx(_components.p,{children:`Report the build identity of the Sumvin server this connection has reached. Useful for confirming\nthe connection is live before trying anything else.`}),`\n`,_jsxs(Tip,{children:[_jsx(_components.strong,{children:`Try asking your agent:`}),` “Are you connected to Sumvin?“`]}),`\n`,_jsx(Heading,{level:`3`,id:`sumvin_guide`,children:`sumvin_guide`}),`\n`,_jsxs(_components.p,{children:[_jsx(Badge,{children:`Read`}),` · No account needed`]}),`\n`,_jsxs(_components.p,{children:[`Load a Sumvin guide: what Sumvin is, how to use its tools safely, and the reference file for each\ntask. Pass `,_jsx(_components.code,{children:`name`}),` (`,_jsx(_components.code,{children:`sumvin-sigil`}),`, or `,_jsx(_components.code,{children:`sumvin-sigil-onboard`}),` for someone without an account yet),\nand `,_jsx(_components.code,{children:`file`}),` for one of its reference files. It’s the same content a host that supports skills\ninstalls from `,_jsx(_components.code,{children:`skill://sumvin-sigil`}),`, so a host that only calls tools still gets it.`]}),`\n`,_jsxs(Tip,{children:[_jsx(_components.strong,{children:`Try asking your agent:`}),` “How do you use Sumvin?”`]}),`\n`,_jsx(Heading,{level:`2`,id:`in-the-sumvin-app-and-cli`,children:`In the Sumvin app and CLI`}),`\n`,_jsx(_components.p,{children:`These tools answer only when the account holder’s own Sumvin app or the Sumvin CLI calls the\nserver. A connected agent never sees them: calling one from a connector is refused, and the refusal\nsays to manage it in the app or the CLI instead.`}),`\n`,_jsx(Heading,{level:`3`,id:`allocations_query`,children:`allocations_query`}),`\n`,_jsx(Badge,{children:`Read`}),`\n`,_jsx(_components.p,{children:`List what has been spent against an errand’s mandate, newest first, and whether each spend has\nsettled.`}),`\n`,_jsx(Heading,{level:`3`,id:`budget_query`,children:`budget_query`}),`\n`,_jsx(Badge,{children:`Read`}),`\n`,_jsx(_components.p,{children:`Read the account holder’s budgets, by name, type, or the kind of spending they cover.`}),`\n`,_jsx(Heading,{level:`3`,id:`budget_upsert`,children:`budget_upsert`}),`\n`,_jsx(Badge,{children:`Write`}),`\n`,_jsx(_components.p,{children:`Create a budget, or replace one in full.`}),`\n`,_jsx(Heading,{level:`3`,id:`budget_delete`,children:`budget_delete`}),`\n`,_jsx(Badge,{children:`Write`}),`\n`,_jsx(_components.p,{children:`Delete a budget. It stops counting spending; its history is kept.`}),`\n`,_jsx(Heading,{level:`3`,id:`card_query`,children:`card_query`}),`\n`,_jsx(Badge,{children:`Read`}),`\n`,_jsx(_components.p,{children:`Read the account holder’s cards and their current status.`}),`\n`,_jsx(Heading,{level:`3`,id:`card_action`,children:`card_action`}),`\n`,_jsx(Badge,{children:`Write`}),`\n`,_jsx(_components.p,{children:`Freeze a card, or unfreeze it. Neither cancels the card or touches payments already made.`}),`\n`,_jsx(Heading,{level:`3`,id:`rule_query`,children:`rule_query`}),`\n`,_jsx(Badge,{children:`Read`}),`\n`,_jsx(_components.p,{children:`Read the account holder’s rules.`}),`\n`,_jsx(Heading,{level:`3`,id:`rule_upsert`,children:`rule_upsert`}),`\n`,_jsx(Badge,{children:`Write`}),`\n`,_jsx(_components.p,{children:`Create a rule, or replace one in full.`}),`\n`,_jsx(Heading,{level:`3`,id:`rule_delete`,children:`rule_delete`}),`\n`,_jsx(Badge,{children:`Write`}),`\n`,_jsx(_components.p,{children:`Delete a rule. It stops applying from then on.`}),`\n`,_jsx(Heading,{level:`3`,id:`strategy_list`,children:`strategy_list`}),`\n`,_jsx(Badge,{children:`Read`}),`\n`,_jsx(_components.p,{children:`List the strategies the account holder can enrol in.`}),`\n`,_jsx(Heading,{level:`3`,id:`user_strategy_query`,children:`user_strategy_query`}),`\n`,_jsx(Badge,{children:`Read`}),`\n`,_jsx(_components.p,{children:`Read the strategies the account holder is enrolled in.`}),`\n`,_jsx(Heading,{level:`3`,id:`user_strategy_create`,children:`user_strategy_create`}),`\n`,_jsx(Badge,{children:`Write`}),`\n`,_jsx(_components.p,{children:`Enrol the account holder in a strategy, after checking that whatever it needs is in place.`}),`\n`,_jsx(Heading,{level:`3`,id:`user_strategy_update`,children:`user_strategy_update`}),`\n`,_jsx(Badge,{children:`Write`}),`\n`,_jsx(_components.p,{children:`Pause or restart an enrolment, or adjust its settings.`}),`\n`,_jsx(Heading,{level:`3`,id:`user_agent_task_query`,children:`user_agent_task_query`}),`\n`,_jsx(Badge,{children:`Read`}),`\n`,_jsx(_components.p,{children:`Read the runs queued or completed for the account holder’s strategies.`}),`\n`,_jsx(Heading,{level:`3`,id:`user_agent_task_manage`,children:`user_agent_task_manage`}),`\n`,_jsx(Badge,{children:`Write`}),`\n`,_jsx(_components.p,{children:`Queue a strategy run, or cancel one that hasn’t started.`}),`\n`,_jsx(Heading,{level:`3`,id:`wallet_update`,children:`wallet_update`}),`\n`,_jsx(Badge,{children:`Write`}),`\n`,_jsx(_components.p,{children:`Rename a wallet, or make it the account holder’s main one.`})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":{"theme":{"light":"vitesse-light","dark":"vitesse-dark"}},"config":{},"pageMetadata":{"title":"MCP tools","description":"Every tool a connected agent gets on the Sumvin MCP connector, grouped by what it's for.","icon":"wrench","href":"/reference/mcp/tools"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Getting started","slug":"getting-started","depth":2,"children":[{"title":"onboarding_status","slug":"onboarding_status","depth":3,"children":[]},{"title":"kyc_start","slug":"kyc_start","depth":3,"children":[]}]},{"title":"Identity","slug":"identity","depth":2,"children":[{"title":"sigil_show","slug":"sigil_show","depth":3,"children":[]},{"title":"agent_identity_show","slug":"agent_identity_show","depth":3,"children":[]}]},{"title":"Stamped Mandates","slug":"stamped-mandates","depth":2,"children":[{"title":"mandate_request","slug":"mandate_request","depth":3,"children":[]},{"title":"mandate_status","slug":"mandate_status","depth":3,"children":[]},{"title":"mandate_verify","slug":"mandate_verify","depth":3,"children":[]},{"title":"mandate_capacity_query","slug":"mandate_capacity_query","depth":3,"children":[]},{"title":"pint_query","slug":"pint_query","depth":3,"children":[]},{"title":"pint_revoke","slug":"pint_revoke","depth":3,"children":[]}]},{"title":"Payment methods","slug":"payment-methods","depth":2,"children":[{"title":"payment_method_query","slug":"payment_method_query","depth":3,"children":[]},{"title":"payment_method_add","slug":"payment_method_add","depth":3,"children":[]}]},{"title":"Errands","slug":"errands","depth":2,"children":[{"title":"errand_create","slug":"errand_create","depth":3,"children":[]},{"title":"errand_action","slug":"errand_action","depth":3,"children":[]},{"title":"errand_query","slug":"errand_query","depth":3,"children":[]},{"title":"errand_events_query","slug":"errand_events_query","depth":3,"children":[]}]},{"title":"Account","slug":"account","depth":2,"children":[{"title":"account_query","slug":"account_query","depth":3,"children":[]},{"title":"wallet_query","slug":"wallet_query","depth":3,"children":[]},{"title":"transaction_query","slug":"transaction_query","depth":3,"children":[]},{"title":"asset_query","slug":"asset_query","depth":3,"children":[]}]},{"title":"Server","slug":"server","depth":2,"children":[{"title":"server_info","slug":"server_info","depth":3,"children":[]},{"title":"sumvin_guide","slug":"sumvin_guide","depth":3,"children":[]}]},{"title":"In the Sumvin app and CLI","slug":"in-the-sumvin-app-and-cli","depth":2,"children":[{"title":"allocations_query","slug":"allocations_query","depth":3,"children":[]},{"title":"budget_query","slug":"budget_query","depth":3,"children":[]},{"title":"budget_upsert","slug":"budget_upsert","depth":3,"children":[]},{"title":"budget_delete","slug":"budget_delete","depth":3,"children":[]},{"title":"card_query","slug":"card_query","depth":3,"children":[]},{"title":"card_action","slug":"card_action","depth":3,"children":[]},{"title":"rule_query","slug":"rule_query","depth":3,"children":[]},{"title":"rule_upsert","slug":"rule_upsert","depth":3,"children":[]},{"title":"rule_delete","slug":"rule_delete","depth":3,"children":[]},{"title":"strategy_list","slug":"strategy_list","depth":3,"children":[]},{"title":"user_strategy_query","slug":"user_strategy_query","depth":3,"children":[]},{"title":"user_strategy_create","slug":"user_strategy_create","depth":3,"children":[]},{"title":"user_strategy_update","slug":"user_strategy_update","depth":3,"children":[]},{"title":"user_agent_task_query","slug":"user_agent_task_query","depth":3,"children":[]},{"title":"user_agent_task_manage","slug":"user_agent_task_manage","depth":3,"children":[]},{"title":"wallet_update","slug":"wallet_update","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":[],"subdomain":"sumvin","siteName":"Sumvin","title":"MCP tools - Sumvin","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-14T08:08:07.871Z","originalFileLocation":"reference/mcp/tools.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Every tool a connected agent gets on the Sumvin MCP connector, grouped by what it\u0026#x27;s for.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Sumvin\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/sumvin/FEs-dgL48CXm4lte/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/sumvin/FEs-dgL48CXm4lte/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/sumvin/FEs-dgL48CXm4lte/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/sumvin/FEs-dgL48CXm4lte/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/sumvin/FEs-dgL48CXm4lte/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/sumvin/FEs-dgL48CXm4lte/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/sumvin/FEs-dgL48CXm4lte/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/sumvin/FEs-dgL48CXm4lte/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/sumvin/FEs-dgL48CXm4lte/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"MCP tools - Sumvin\">\u003cmeta data-mint-head property=\"og:description\" content=\"Every tool a connected agent gets on the Sumvin MCP connector, grouped by what it\u0026#x27;s for.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Sumvin Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.sumvin.com/reference/mcp/tools\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://sumvin.mintlify.site/_mintlify/api/og/v2?division=MCP+server\u0026amp;title=MCP+tools\u0026amp;description=Every+tool+a+connected+agent+gets+on+the+Sumvin+MCP+connector%2C+grouped+by+what+it%27s+for.\u0026amp;theme=3d88a2393dbf57d4e89837b2\u0026amp;signature=badb9053aee9ed8f4be5025f7fecc62d8f03c3e6d26de5885dae717d268f1f27\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"MCP tools - Sumvin\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Every tool a connected agent gets on the Sumvin MCP connector, grouped by what it\u0026#x27;s for.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://sumvin.mintlify.site/_mintlify/api/og/v2?division=MCP+server\u0026amp;title=MCP+tools\u0026amp;description=Every+tool+a+connected+agent+gets+on+the+Sumvin+MCP+connector%2C+grouped+by+what+it%27s+for.\u0026amp;theme=3d88a2393dbf57d4e89837b2\u0026amp;signature=badb9053aee9ed8f4be5025f7fecc62d8f03c3e6d26de5885dae717d268f1f27\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/sumvin/FEs-dgL48CXm4lte/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Sumvin\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1A6B3C\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.sumvin.com/reference/mcp/tools\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/reference/mcp/tools.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.sumvin.com/#organization\",\"name\":\"Sumvin\",\"url\":\"https://docs.sumvin.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/sumvin/iFVoZsDR9WS3r7Vw/logo/light.svg?fit=max\u0026auto=format\u0026n=iFVoZsDR9WS3r7Vw\u0026q=85\u0026s=94c21eea5f2b742115618f128bafa28b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.sumvin.com#website\",\"name\":\"Sumvin\",\"url\":\"https://docs.sumvin.com\",\"publisher\":{\"@id\":\"https://docs.sumvin.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.sumvin.com/reference/mcp/tools#webpage\",\"url\":\"https://docs.sumvin.com/reference/mcp/tools\",\"name\":\"MCP tools\",\"description\":\"Every tool a connected agent gets on the Sumvin MCP connector, grouped by what it's for.\",\"dateModified\":\"2026-10-14T08:08:07.871Z\",\"isPartOf\":{\"@id\":\"https://docs.sumvin.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.sumvin.com/reference/mcp/tools#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.sumvin.com/reference/mcp/tools#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Sumvin\",\"item\":\"https://docs.sumvin.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"MCP tools\",\"item\":\"https://docs.sumvin.com/reference/mcp/tools\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.sumvin.com/reference/mcp/tools#article\",\"headline\":\"MCP tools\",\"name\":\"MCP tools\",\"description\":\"Every tool a connected agent gets on the Sumvin MCP connector, grouped by what it's for.\",\"url\":\"https://docs.sumvin.com/reference/mcp/tools\",\"mainEntityOfPage\":{\"@id\":\"https://docs.sumvin.com/reference/mcp/tools#webpage\"},\"dateModified\":\"2026-10-14T08:08:07.871Z\",\"publisher\":{\"@id\":\"https://docs.sumvin.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.sumvin.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Sumvin\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Sumvin\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/reference/mcp/tools.md","siteName":"Sumvin","nav":{"global":{"anchors":[{"anchor":"Changelog","icon":"history","href":"/changelog"},{"anchor":"Get help","icon":"life-buoy","href":"mailto:hello@sumvin.com"}]},"tabs":[{"tab":"Get started","icon":"compass","pages":[{"title":"Get started","href":""}]},{"tab":"Concepts","icon":"book-open","pages":[{"title":"Concepts","href":"/concepts/sigil"}]},{"tab":"Guides","icon":"map","pages":[{"title":"Guides","href":"/guides/approve-or-decline"}]},{"tab":"Reference","icon":"square-terminal","groups":[{"group":"MCP server","pages":[{"title":"MCP tools","icon":"wrench","href":"/reference/mcp/tools"},{"title":"Refusals","description":"What it means when a connected agent's tool call is refused, and what to do next.","icon":"octagon-x","href":"/reference/mcp/refusals"},{"title":"Rate limits","icon":"gauge","href":"/reference/mcp/limits"}]},{"group":"CLI","pages":[{"title":"sumvin login, logout, whoami","icon":"log-in","href":"/reference/cli/auth"},{"title":"sumvin kyc","icon":"id-card","href":"/reference/cli/kyc"},{"title":"sumvin sigil","icon":"badge-check","href":"/reference/cli/sigil"},{"title":"sumvin keys","icon":"key-round","href":"/reference/cli/keys"},{"title":"Stamped Mandates (sumvin pint)","icon":"shield-check","href":"/reference/cli/pint"},{"title":"sumvin errand","icon":"shopping-cart","href":"/reference/cli/errand"},{"title":"The --json contract","icon":"braces","href":"/reference/cli/json-output"}]},{"group":"Status and errors","pages":[{"title":"Errors","icon":"triangle-alert","href":"/reference/errors"},{"title":"Status labels","icon":"tag","href":"/reference/status-labels"},{"title":"Contact support","sidebarTitle":"Support","icon":"life-buoy","href":"/support"}]}]},{"tab":"SDK","icon":"package","pages":[{"title":"SDK","href":"/sdk/overview"}]}]},"basePath":"","title":"MCP tools - Sumvin","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}