Catalog MCP tool: price one call to a service without paying it — the live, fee-inclusive total, rail, and network.
Price one call to a service without paying it: it charges nothing, signs nothing, and reserves no budget. Pass exactly what you’d pass to pay_service; the Router sends that request to the service unpaid, reads the price, and returns a quoteId plus the fee-inclusive total. Needs a credential (API key or OAuth commerce grant).Auth: key / grant · Charges: nothing
A quote contacts the service. To read the price, the Router sends your request to the service unpaid — the same request a payment starts with. A service that doesn’t charge for it performs it, so take care quoting a method with side effects. The service’s response is never returned to you. A quote also spends the same per-service rate limit as a payment, so quote once per decision; don’t poll.
Arguments
Argument
Required
Type
Description
slug
yes
string
The service slug to quote.
path
no
string
The same path you’d pass to pay_service (from get_service), placeholders replaced. Query params go in search.
search
no
string
Query string without ?, for a slug-routed GET (e.g. flight_iata=AA217).
method
no
string
HTTP method. Omit to use the catalog method for the endpoint matching path (POST when none recorded).
body
no
any
The request payload you’d send; some services price by it.
headers
no
object
Extra headers you’d send to the vendor.
delegationId
no
string
The delegation you’d pay with (API key only). A card or org-wallet delegation can select a different rail, and so a different price. An OAuth caller is always quoted for its grant.
requireProtocol
no
string
Price only x402 or mpp. Pass the same pin to pay_service; the returned quoteId binds that rail. If unavailable, returns quote_failed with BCK.ROUTER.0045, nothing charged. Omit to auto-select (MPP first). A subscription-credit quote prices the rail this pin names, and the paid call enforces it.
funding
no
string
"subscription" or "delegation", as on pay_service. Omit it to get the price in credits when your Nevermined credits can pay this call, and the delegation quote otherwise.
Returns
The rail, the merchant amount, and the fee-inclusive total. fee.capChargedCents is whole cents rounded up; fee.capChargedMicros is exact (1/10,000 of a cent):
optionSet: "delegation" — the delegation pay_service would charge, named in delegationId.
optionSet: "deployment" — you have no delegation yet, so this is what a personal crypto delegation would select; nextTool is setup_delegation. Set one up and quote again before paying — the delegation you create can select a different rail and price.
paymentRequired: false — the service didn’t ask for payment for this request; upstreamStatus is its answer. A non-2xx usually means the path, method or body is wrong.
sessionDeposit, present when settlement.scheme is session, is what this call would do to your wallet on top of its price. The service is paid out of a deposit in a payment channel, and that deposit can far exceed the price of the call. It is locked, not spent, it isn’t charged to your budget, and what the service doesn’t use comes back when the channel closes, idleCloseSeconds after its last use. Tell the human before paying.
Field
Meaning
action
open (this call locks a deposit), top_up (it locks more), none (your channel covers it, so no new money leaves the wallet), closing (the call would be refused and nothing moves; quote again once it has closed), or null (what the call would do couldn’t be stated, and pay_service may refuse it, so approxCents is only the most it could be).
amount / approxCents
How much would move into the deposit, in the token’s smallest unit and in cents, the network fee not included.
basis
sized for this budget and wallet as they stand now, or upper_bound: the most it could lock.
To pay with the quote pinned, pass quoteId to pay_service before expiresAt with the exact same call arguments. The quote id fixes the challenge and the exact fee-inclusive total; keep maxTotalCents as an independent ceiling.
Quote in subscription credits
When your Nevermined credits can pay this call — from a subscription, free credits or top-up packs — quote_service answers with the exact credits of this request. Credits follow each service’s live price, with a 1-credit minimum, so the service is sent your request unpaid, as for a delegation quote: pass everything you would pass to pay_service, and the warning above applies:
{ "funding": "subscription", "slug": "webscrape-pro", "credits": 216, "paymentRequired": true, "upstreamStatus": 402, "request": { "method": "POST", "path": "/scrape", "methodSource": "catalog", "catalogEndpoint": "/scrape" }, "nextTool": "pay_service", "maxCredits": 216, "instructions": "Nothing was charged. `credits` is the exact number of Nevermined credits this request costs now …"}
credits is what this exact request costs now. There’s no quoteId or cent total: pay with pay_service, the same arguments and the maxCredits this answer gives, so a call that has become dearer is refused and charges nothing. paymentRequired: false means the service did not ask to be paid for this request: it named no price, credits is 0, and upstreamStatus is its answer. For a subscriber in good standing, the quote doesn’t check the credits left (without one, it checks that they cover the call, unless an automatic top-up would); it never checks Nevermined’s treasury — pay_service checks that when it makes the call. funding follows the same rules as on pay_service: omitted, a call credits can’t price gets the delegation quote instead, with fundingReason; with funding: "subscription", it is refused with the same error names.
The delegation refuses session payments, and nothing else can pay this call.
Use a service that charges per call, or report to the human, who can deliberately drop a requireProtocol: "mpp" pin or create a delegation that allows them. An app connected over OAuth holds its delegation through its grant, so they disconnect the app in Nevermined and reconnect it with session payments allowed instead.
{ "error": "credential_refused" }
Your credential was refused.
Re-authorize.
Try it
Ask your assistant:
Quote a current-weather call to openweather-mpp for Lisbon before paying.
Call it directly (charges nothing, but reaches the service — see the warning above):
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Nevermined Documentation","colors":{"primary":"#0f766e","light":"#5eead4","dark":"#0d3f48"},"logo":{"light":"https://mintcdn.com/neverminedag/pEEAPbhrOtjiJvrW/logo/light.svg?fit=max\u0026auto=format\u0026n=pEEAPbhrOtjiJvrW\u0026q=85\u0026s=adbff4ad34c53aed8ca307e9b12104e5","dark":"https://mintcdn.com/neverminedag/pEEAPbhrOtjiJvrW/logo/dark.svg?fit=max\u0026auto=format\u0026n=pEEAPbhrOtjiJvrW\u0026q=85\u0026s=519fb2296e47f72117a24e0787b6bd87"},"favicon":"https://mintcdn.com/neverminedag/816P0WhT1WcQ-Koj/favicon.ico?fit=max\u0026auto=format\u0026n=816P0WhT1WcQ-Koj\u0026q=85\u0026s=2ff33e631489dd6cca6be632af8aa16a","api":{"openapi":"api-reference/openapi.json"},"appearance":{"default":"light"},"navbar":{"links":[{"href":"https://nevermined.app","label":"App"}],"primary":{"type":"button","label":"AI Catalog","href":"https://nevermined.app/catalog/"}},"footer":{"socials":{"x":"https://x.com/nevermined_ai","github":"https://github.com/nevermined-io","linkedin":"https://linkedin.com/company/nevermined","discord":"https://discord.com/invite/GZju2qScKq"}},"seo":{"metatags":{"canonical":"https://nevermined.ai/docs"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"markdown":{"instructions":["If you are an agent buying services: start with these steps. Every page has a .md version.","1. Install the Catalog MCP (live server https://mcp.live.nevermined.app/mcp, sandbox server https://mcp.sandbox.nevermined.app/mcp; rehearse on sandbox with a sandbox API key before live, as keys work only in their own environment; Claude Code and Cursor commands, Codex config.toml entry): https://nevermined.ai/docs/products/catalog/mcp.md","2. Get an API key: https://nevermined.ai/docs/agents-guide/get-api-key.md","3. Enroll a card and create a delegation (a payment method plus a spend mandate: an amount, an expiry and a number of purchases): https://nevermined.ai/docs/agents-guide/enroll-card.md","4. Buy and call a paid agent over x402: https://nevermined.ai/docs/getting-started/ai-agent-purchase.md","SDK quickstart: https://nevermined.ai/docs/integrate/quickstart/typescript.md. Pricing: https://nevermined.ai/pricing/"]},"styling":{"latex":true},"navigation":{"global":{"anchors":[]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"neverminedag","hasAudioNarration":false,"actualSubdomain":"neverminedag","customDomains":["nevermined.ai"],"gitSource":{"type":"github","owner":"nevermined-io","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"agentFeedback":true,"thumbs":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6afb45dc3b86427e404ee732","clientVersion":"0.0.4167","searchFilterCounts":[{"language":"default","tag":"API","count":147},{"language":"default","tag":"Guides","count":132},{"language":"default","tag":"Organizations","count":96},{"language":"default","tag":"Nevermined Catalog","count":50},{"language":"default","tag":"SDK","count":35},{"language":"default","tag":"Connect from a host","count":29},{"language":"default","tag":"Integrations","count":21},{"language":"default","tag":"MCP","count":18},{"language":"default","tag":"Authentication","count":17},{"language":"default","tag":"Learn","count":16}]},"assistantConfig":{"deflection":{"enabled":true,"email":"support@nevermined.io","showHelpButton":true}},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"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":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":"img.nav-logo{max-height:20px!important;height:20px!important;width:auto!important}.nav-tabs{gap:0!important;padding:0!important}a.nav-tabs-item{padding:8px 16px!important;font-size:14px!important;font-weight:500!important;min-width:auto!important;border-radius:0!important;background:transparent!important}a.nav-tabs-item:hover{color:#0f766e!important;background:transparent!important}.dark a.nav-tabs-item,[data-theme=\"dark\"] a.nav-tabs-item{color:#d1d5db!important}.dark a.nav-tabs-item:hover,[data-theme=\"dark\"] a.nav-tabs-item:hover{color:#5eead4!important}@media (max-width: 768px){a.nav-tabs-item{padding:6px 12px!important;font-size:13px!important}}.nvm-hero-banner{position:relative;background-color:#0d3f48;border-radius:24px;padding:48px 32px;margin-bottom:32px;overflow:hidden;min-height:320px;display:flex;flex-direction:column;justify-content:center}.nvm-hero-banner::before{content:'';position:absolute;top:0;left:0;right:0;bottom:0;background-image:url('/images/product_hero.jpg');background-size:cover;background-position:center right;opacity:0.9}.nvm-hero-content{position:relative;z-index:1;max-width:600px}.nvm-hero-label{color:white;font-size:12px;font-weight:600;letter-spacing:2px;text-transform:uppercase;margin-bottom:16px;opacity:0.9}.nvm-hero-title{font-size:clamp(28px, 5vw, 48px);font-weight:300;line-height:1.1;margin-bottom:20px}.nvm-gradient-text{background:linear-gradient(114.57deg, #bcdc4a 23%, #abe2dd 60%);-webkit-background-clip:text;-webkit-text-fill-color:transparent;background-clip:text;font-style:italic}.nvm-hero-title-white{color:white;display:block;margin-top:4px}.nvm-hero-description{color:rgba(255, 255, 255, 0.85);font-size:16px;line-height:1.6;margin-bottom:24px;max-width:500px}.nvm-hero-button{display:inline-block;background-color:white;color:#0d3f48!important;padding:12px 24px;border-radius:8px;font-size:14px;font-weight:600;text-decoration:none!important;transition:all 0.2s ease;border:none;cursor:pointer}.nvm-hero-button:hover{background-color:#f0f0f0;transform:translateY(-1px);text-decoration:none!important}@media (max-width: 768px){.nvm-hero-banner{padding:32px 24px;min-height:280px}.nvm-hero-banner::before{background-position:center center;opacity:0.7}.nvm-hero-title{font-size:28px}.nvm-hero-description{font-size:14px}}.prose,.prose p,.prose li,article p,article li{font-size:15px!important;line-height:1.6!important}.prose h1,article h1{font-size:27px!important}.prose h2,article h2{font-size:21px!important}.prose h3,article h3{font-size:17px!important}.prose h4,article h4{font-size:15px!important}#sidebar a.group{padding-top:4px!important;padding-bottom:4px!important}#sidebar li{margin:1px 0!important}.sidebar-group-header{gap:6px!important;margin-bottom:4px!important;padding-left:12px!important}#sidebar .mt-6,#sidebar .lg\\:mt-8{margin-top:20px!important}ul.sidebar-group{gap:0!important}#sidebar-content{padding-top:12px!important;padding-bottom:12px!important}#navigation-items{font-size:13px!important}:is(a,button,input,select,textarea,summary,[tabindex]:not([tabindex=\"-1\"]),[role=\"button\"],[role=\"link\"],[role=\"tab\"],[role=\"menuitem\"],[role=\"option\"],[role=\"checkbox\"],[role=\"switch\"]):focus-visible{outline:2px solid #0f766e!important;outline-offset:2px!important}.dark :is(a,button,input,select,textarea,summary,[tabindex]:not([tabindex=\"-1\"]),[role=\"button\"],[role=\"link\"],[role=\"tab\"],[role=\"menuitem\"],[role=\"option\"],[role=\"checkbox\"],[role=\"switch\"]):focus-visible,[data-theme=\"dark\"] :is(a,button,input,select,textarea,summary,[tabindex]:not([tabindex=\"-1\"]),[role=\"button\"],[role=\"link\"],[role=\"tab\"],[role=\"menuitem\"],[role=\"option\"],[role=\"checkbox\"],[role=\"switch\"]):focus-visible{outline-color:#5eead4!important}#navbar{background-color:rgb(var(--background-light, 255 255 255))!important;border-bottom:1px solid #e5e7eb!important}.dark #navbar,[data-theme=\"dark\"] #navbar{background-color:rgb(var(--background-dark, 11 14 15))!important;border-bottom-color:rgba(255, 255, 255, 0.08)!important}#navbar{--nvmbg-ink: #0d3f48}.dark #navbar,[data-theme=\"dark\"] #navbar{--nvmbg-ink: #4ac6bf}#navbar::after{content:\"\";position:absolute;inset:0;z-index:1;pointer-events:none;background-image:url(\"data:image/svg+xml,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20width%3D%22600%22%20height%3D%22130%22%20viewBox%3D%220%200%20600%20130%22%20fill%3D%22none%22%3E%3Cg%20stroke%3D%22%230d3f48%22%20stroke-opacity%3D%220.09%22%20stroke-width%3D%221%22%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%2240%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%2266%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%2292%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%22118%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%22144%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%22170%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%22196%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%22222%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%22248%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%22274%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%22300%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%22326%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%22352%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%22378%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%22404%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%22430%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%22456%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%22482%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%22508%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%22534%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%22560%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%22586%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%22612%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%22638%22%2F%3E%3C%2Fg%3E%3Cg%20stroke%3D%22%230d3f48%22%20stroke-opacity%3D%220.04%22%20stroke-width%3D%221%22%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%2240%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%2266%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%2292%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%22118%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%22144%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%22170%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%22196%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%22222%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%22248%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%22274%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%22300%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%22326%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%22352%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%22378%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%22404%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%22430%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%22456%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%22482%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%22508%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%22534%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%22560%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%22586%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%22612%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%22638%22%2F%3E%3C%2Fg%3E%3C%2Fsvg%3E\");background-repeat:no-repeat;background-position:top right;background-size:600px 130px}.dark #navbar::after,[data-theme=\"dark\"] #navbar::after{background-image:url(\"data:image/svg+xml,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20width%3D%22600%22%20height%3D%22130%22%20viewBox%3D%220%200%20600%20130%22%20fill%3D%22none%22%3E%3Cg%20stroke%3D%22%234ac6bf%22%20stroke-opacity%3D%220.1%22%20stroke-width%3D%221%22%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%2240%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%2266%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%2292%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%22118%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%22144%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%22170%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%22196%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%22222%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%22248%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%22274%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%22300%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%22326%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%22352%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%22378%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%22404%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%22430%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%22456%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%22482%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%22508%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%22534%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%22560%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%22586%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%22612%22%2F%3E%3Ccircle%20cx%3D%22600%22%20cy%3D%220%22%20r%3D%22638%22%2F%3E%3C%2Fg%3E%3Cg%20stroke%3D%22%234ac6bf%22%20stroke-opacity%3D%220.045%22%20stroke-width%3D%221%22%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%2240%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%2266%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%2292%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%22118%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%22144%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%22170%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%22196%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%22222%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%22248%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%22274%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%22300%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%22326%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%22352%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%22378%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%22404%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%22430%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%22456%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%22482%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%22508%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%22534%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%22560%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%22586%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%22612%22%2F%3E%3Ccircle%20cx%3D%22618%22%20cy%3D%2214%22%20r%3D%22638%22%2F%3E%3C%2Fg%3E%3C%2Fsvg%3E\")}#navbar::before{content:\"\";position:absolute;inset:0;z-index:1;pointer-events:none;opacity:0.06;background-image:repeating-linear-gradient(\n 45deg,\n var(--nvmbg-ink) 0,\n var(--nvmbg-ink) 0.5px,\n transparent 0.5px,\n transparent 5px\n );-webkit-mask-image:radial-gradient(120% 140% at 0 0, #000 0%, transparent 55%);mask-image:radial-gradient(120% 140% at 0 0, #000 0%, transparent 55%)}#navbar div:has(>nav #topbar-cta-button)>nav{order:1;margin-inline:1rem 0}#navbar div:has(>nav #topbar-cta-button)>div{margin-inline:0}#topbar-cta-button>a{--catalog-accent: #12a89e;--catalog-lime: #8fbf1f;position:relative;display:inline-flex;align-items:center;padding:13px 22px 13px 57px;border-radius:12px;background:#0d3f48;font-size:15px;font-weight:600;line-height:1}:is(.dark,[data-theme=\"dark\"]) #topbar-cta-button>a{--catalog-accent: #4ac6bf;--catalog-lime: #bcdc4a}#topbar-cta-button>a>span.absolute,#topbar-cta-button>a>div>svg{display:none}#topbar-cta-button>a::before,#topbar-cta-button>a::after{content:\"\";position:absolute;left:22px;top:50%;transform:translateY(-50%);width:24px;height:17px;background-color:var(--catalog-accent);mask:var(--catalog-ribbon) center / contain no-repeat;-webkit-mask:var(--catalog-ribbon) center / contain no-repeat;pointer-events:none}#topbar-cta-button>a::before{--catalog-ribbon: url(\"data:image/svg+xml,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20viewBox%3D%220%200%2031.06%2022%22%3E%3Cpath%20d%3D%22M0%2011.153L10.4179%2020.6426V11.0576L0%201.56805V11.153Z%22%2F%3E%3C%2Fsvg%3E\")}#topbar-cta-button>a::after{--catalog-ribbon: url(\"data:image/svg+xml,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20viewBox%3D%220%200%2031.06%2022%22%3E%3Cpath%20d%3D%22M10.4178%201.56805V11.153L20.8325%2020.6426L31.0596%2011.153V1.56805L20.8325%2011.0576L10.4178%201.56805Z%22%2F%3E%3C%2Fsvg%3E\")}@media (prefers-reduced-motion: no-preference){#topbar-cta-button>a:is(:hover,:focus-visible)::before,#topbar-cta-button>a:is(:hover,:focus-visible)::after{animation:nvm-catalog-shimmer .8s ease-in-out infinite}#topbar-cta-button>a:is(:hover,:focus-visible)::after{animation-delay:.12s}}@keyframes nvm-catalog-shimmer{0%,100%{background-color:var(--catalog-accent)}50%{background-color:var(--catalog-lime)}}"}],"page":{"pagePath":"mcp/catalog-mcp/quote-service","slug":"/mcp/catalog-mcp/quote-service","pageMetadata":{"title":"quote_service","sidebarTitle":"Quote Service","description":"Catalog MCP tool: price one call to a service without paying it — the live, fee-inclusive total, rail, and network.","href":"/mcp/catalog-mcp/quote-service"},"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: \"Catalog MCP tool: price one call to a service without paying it — the live, fee-inclusive total, rail, and network.\"\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`,blockquote:`blockquote`,code:`code`,em:`em`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Price `,_jsx(_components.strong,{children:`one`}),` call to a service `,_jsx(_components.strong,{children:`without paying it`}),`: it charges nothing, signs nothing, and reserves no budget. Pass exactly what you’d pass to `,_jsx(_components.a,{href:`/mcp/catalog-mcp/pay-service`,children:_jsx(_components.code,{children:`pay_service`})}),`; the Router sends that request to the service unpaid, reads the price, and returns a `,_jsx(_components.code,{children:`quoteId`}),` plus the fee-inclusive total. Needs a credential (API key or OAuth `,_jsx(_components.code,{children:`commerce`}),` grant).`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Auth:`}),` key / grant · `,_jsx(_components.strong,{children:`Charges:`}),` nothing`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`A quote contacts the service.`}),` To read the price, the Router sends your request to the service unpaid — the same request a payment starts with. A service that doesn’t charge for it `,_jsx(_components.strong,{children:`performs it`}),`, so take care quoting a method with side effects. The service’s response is never returned to you. A quote also spends the same per-service rate limit as a payment, so quote `,_jsx(_components.strong,{children:`once per decision`}),`; don’t poll.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`arguments`,children:`Arguments`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Argument`}),_jsx(_components.th,{children:`Required`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`slug`})}),_jsx(_components.td,{children:`yes`}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`The service slug to quote.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`path`})}),_jsx(_components.td,{children:`no`}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`The same `,_jsx(_components.code,{children:`path`}),` you’d pass to `,_jsx(_components.code,{children:`pay_service`}),` (from `,_jsx(_components.a,{href:`/mcp/catalog-mcp/get-service`,children:_jsx(_components.code,{children:`get_service`})}),`), placeholders replaced. Query params go in `,_jsx(_components.code,{children:`search`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`search`})}),_jsx(_components.td,{children:`no`}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`Query string without `,_jsx(_components.code,{children:`?`}),`, for a slug-routed `,_jsx(_components.code,{children:`GET`}),` (e.g. `,_jsx(_components.code,{children:`flight_iata=AA217`}),`).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`method`})}),_jsx(_components.td,{children:`no`}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`HTTP method. Omit to use the catalog method for the endpoint matching `,_jsx(_components.code,{children:`path`}),` (`,_jsx(_components.code,{children:`POST`}),` when none recorded).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`body`})}),_jsx(_components.td,{children:`no`}),_jsx(_components.td,{children:`any`}),_jsx(_components.td,{children:`The request payload you’d send; some services price by it.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`headers`})}),_jsx(_components.td,{children:`no`}),_jsx(_components.td,{children:`object`}),_jsx(_components.td,{children:`Extra headers you’d send to the vendor.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`delegationId`})}),_jsx(_components.td,{children:`no`}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`The delegation you’d pay with (API key only). A card or org-wallet delegation can select a different rail, and so a different price. An OAuth caller is always quoted for its grant.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`requireProtocol`})}),_jsx(_components.td,{children:`no`}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`Price only `,_jsx(_components.code,{children:`x402`}),` or `,_jsx(_components.code,{children:`mpp`}),`. Pass the same pin to `,_jsx(_components.code,{children:`pay_service`}),`; the returned `,_jsx(_components.code,{children:`quoteId`}),` binds that rail. If unavailable, returns `,_jsx(_components.code,{children:`quote_failed`}),` with `,_jsx(_components.code,{children:`BCK.ROUTER.0045`}),`, nothing charged. Omit to auto-select (MPP first). A subscription-credit quote prices the rail this pin names, and the paid call enforces it.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`funding`})}),_jsx(_components.td,{children:`no`}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`\"subscription\"`}),` or `,_jsx(_components.code,{children:`\"delegation\"`}),`, as on `,_jsx(_components.code,{children:`pay_service`}),`. Omit it to get the `,_jsx(_components.a,{href:`#quote-in-subscription-credits`,children:`price in credits`}),` when your Nevermined credits can pay this call, and the delegation quote otherwise.`]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`returns`,children:`Returns`}),`\n`,_jsxs(_components.p,{children:[`The rail, the merchant amount, and the fee-inclusive total. `,_jsx(_components.code,{children:`fee.capChargedCents`}),` is whole cents rounded up; `,_jsx(_components.code,{children:`fee.capChargedMicros`}),` is exact (1/10,000 of a cent):`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`15`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`15`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"paymentRequired\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"upstreamStatus\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`402`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"optionSet\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"delegation\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"delegationId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"121b880a-…\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"quoteId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"qt_8f2a…\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"expiresAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-10-02T14:05:00.000Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"protocol\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"x402\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"x402Version\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`2`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"settlement\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"recipient\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0x2096…\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"amount\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"20000\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"asset\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"USDC\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"network\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"base\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"approxCents\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"fee\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"bps\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`200`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"amount\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"400\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"cents\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"capChargedCents\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"3\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"capChargedMicros\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"20400\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"request\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"method\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"POST\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"path\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"/quote\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"methodSource\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"catalog\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"catalogEndpoint\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"/quote\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"nextTool\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"pay_service\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"instructions\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:'\"Nothing was charged. `fee.capChargedCents` is the fee-inclusive total this call would cost.\"'})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:_jsx(_components.code,{children:`optionSet: \"delegation\"`})}),` — the delegation `,_jsx(_components.code,{children:`pay_service`}),` would charge, named in `,_jsx(_components.code,{children:`delegationId`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:_jsx(_components.code,{children:`optionSet: \"deployment\"`})}),` — you have no delegation yet, so this is what a personal crypto delegation `,_jsx(_components.em,{children:`would`}),` select; `,_jsx(_components.code,{children:`nextTool`}),` is `,_jsx(_components.code,{children:`setup_delegation`}),`. Set one up and `,_jsx(_components.strong,{children:`quote again`}),` before paying — the delegation you create can select a different rail and price.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:_jsx(_components.code,{children:`paymentRequired: false`})}),` — the service didn’t ask for payment for this request; `,_jsx(_components.code,{children:`upstreamStatus`}),` is its answer. A non-2xx usually means the `,_jsx(_components.code,{children:`path`}),`, `,_jsx(_components.code,{children:`method`}),` or `,_jsx(_components.code,{children:`body`}),` is wrong.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:_jsx(_components.code,{children:`sessionDeposit`})}),`, present when `,_jsx(_components.code,{children:`settlement.scheme`}),` is `,_jsx(_components.code,{children:`session`}),`, is what this call would do to your wallet on top of its price. The service is paid out of a deposit in a payment channel, and that deposit can far exceed the price of the call. It is locked, not spent, it isn’t charged to your budget, and what the service doesn’t use comes back when the channel closes, `,_jsx(_components.code,{children:`idleCloseSeconds`}),` after its last use. Tell the human before paying.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`action`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`open`}),` (this call locks a deposit), `,_jsx(_components.code,{children:`top_up`}),` (it locks more), `,_jsx(_components.code,{children:`none`}),` (your channel covers it, so no new money leaves the wallet), `,_jsx(_components.code,{children:`closing`}),` (the call would be refused and nothing moves; quote again once it has closed), or `,_jsx(_components.code,{children:`null`}),` (what the call would do couldn’t be stated, and `,_jsx(_components.code,{children:`pay_service`}),` may refuse it, so `,_jsx(_components.code,{children:`approxCents`}),` is only the most it could be).`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`amount`}),` / `,_jsx(_components.code,{children:`approxCents`})]}),_jsx(_components.td,{children:`How much would move into the deposit, in the token’s smallest unit and in cents, the network fee not included.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`basis`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`sized`}),` for this budget and wallet as they stand now, or `,_jsx(_components.code,{children:`upper_bound`}),`: the most it could lock.`]})]})]})]}),`\n`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`To pay with the quote pinned,`}),` pass `,_jsx(_components.code,{children:`quoteId`}),` to `,_jsx(_components.a,{href:`/mcp/catalog-mcp/pay-service`,children:_jsx(_components.code,{children:`pay_service`})}),` before `,_jsx(_components.code,{children:`expiresAt`}),` with the exact same call arguments. The quote id fixes the challenge and the exact fee-inclusive total; keep `,_jsx(_components.code,{children:`maxTotalCents`}),` as an independent ceiling.`]}),`\n`,_jsx(Heading,{level:`2`,id:`quote-in-subscription-credits`,children:`Quote in subscription credits`}),`\n`,_jsxs(_components.p,{children:[`When your `,_jsx(_components.a,{href:`/products/catalog/router/subscription`,children:`Nevermined credits`}),` can pay this call — from a subscription, free credits or top-up packs — `,_jsx(_components.code,{children:`quote_service`}),` answers with the exact credits of this request. Credits follow each service’s live price, with a 1-credit minimum, so the service is sent your request unpaid, as for a delegation quote: pass everything you would pass to `,_jsx(_components.code,{children:`pay_service`}),`, and the warning above applies:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`11`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`11`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"funding\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"subscription\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"slug\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"webscrape-pro\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"credits\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`216`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"paymentRequired\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"upstreamStatus\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`402`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"request\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"method\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"POST\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"path\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"/scrape\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"methodSource\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"catalog\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"catalogEndpoint\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"/scrape\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"nextTool\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"pay_service\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"maxCredits\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`216`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"instructions\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:'\"Nothing was charged. `credits` is the exact number of Nevermined credits this request costs now …\"'})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`credits`}),` is what this exact request costs now. There’s no `,_jsx(_components.code,{children:`quoteId`}),` or cent total: pay with `,_jsx(_components.code,{children:`pay_service`}),`, the same arguments and the `,_jsx(_components.code,{children:`maxCredits`}),` this answer gives, so a call that has become dearer is refused and charges nothing. `,_jsx(_components.code,{children:`paymentRequired: false`}),` means the service did not ask to be paid for this request: it named no price, `,_jsx(_components.code,{children:`credits`}),` is `,_jsx(_components.code,{children:`0`}),`, and `,_jsx(_components.code,{children:`upstreamStatus`}),` is its answer. For a subscriber in good standing, the quote doesn’t check the credits left (without one, it checks that they cover the call, unless an automatic `,_jsx(_components.a,{href:`/products/catalog/router/subscription#top-ups`,children:`top-up`}),` would); it never checks Nevermined’s treasury — `,_jsx(_components.code,{children:`pay_service`}),` checks that when it makes the call. `,_jsx(_components.code,{children:`funding`}),` follows the same rules as on `,_jsx(_components.a,{href:`/mcp/catalog-mcp/pay-service#pay-with-subscription-credits`,children:_jsx(_components.code,{children:`pay_service`})}),`: omitted, a call credits can’t price gets the delegation quote instead, with `,_jsx(_components.code,{children:`fundingReason`}),`; with `,_jsx(_components.code,{children:`funding: \"subscription\"`}),`, it is refused with the same `,_jsx(_components.a,{href:`/mcp/catalog-mcp/pay-service#refusals-when-paying-with-credits`,children:`error names`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`refusals-all-charge-nothing`,children:`Refusals (all charge nothing)`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Result`}),_jsx(_components.th,{children:`Meaning`}),_jsx(_components.th,{children:`What to do`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`{ \"payable\": false }`})}),_jsx(_components.td,{children:`Not payable via the Router (only x402/MPP are).`}),_jsx(_components.td,{children:`Nothing to quote.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`{ \"error\": \"service_not_found\" }`})}),_jsx(_components.td,{children:`No listed service has that slug.`}),_jsxs(_components.td,{children:[`Check the slug with `,_jsx(_components.code,{children:`search_services`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`{ \"error\": \"catalog_unavailable\" }`}),` / `,_jsx(_components.code,{children:`\"delegation_lookup_failed\"`})]}),_jsx(_components.td,{children:`A read the quote needs failed.`}),_jsx(_components.td,{children:`Transient — retry later.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`{ \"error\": \"quote_unavailable\", \"code\": … }`})}),_jsx(_components.td,{children:`No quote can be made here and retrying won’t change that.`}),_jsxs(_components.td,{children:[`Bound the price with `,_jsx(_components.code,{children:`pay_service`}),`’s `,_jsx(_components.code,{children:`maxTotalCents`}),` instead.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`{ \"error\": \"quote_failed\", \"code\": …, \"retryable\": … }`})}),_jsx(_components.td,{children:`The Router refused to price, or didn’t answer.`}),_jsxs(_components.td,{children:[`Read `,_jsx(_components.code,{children:`code`}),` / `,_jsx(_components.code,{children:`message`}),` / `,_jsx(_components.code,{children:`retryable`}),`; a no-answer is safe to retry.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`{ \"error\": \"quote_failed\", \"code\": \"BCK.ROUTER.0047\" }`})}),_jsx(_components.td,{children:`The delegation refuses session payments, and nothing else can pay this call.`}),_jsxs(_components.td,{children:[`Use a service that charges per call, or report to the human, who can deliberately drop a `,_jsx(_components.code,{children:`requireProtocol: \"mpp\"`}),` pin or create a delegation that allows them. An app connected over OAuth holds its delegation through its grant, so they disconnect the app in Nevermined and reconnect it with session payments allowed instead.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`{ \"error\": \"credential_refused\" }`})}),_jsx(_components.td,{children:`Your credential was refused.`}),_jsx(_components.td,{children:`Re-authorize.`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`try-it`,children:`Try it`}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Ask your assistant:`})}),`\n`,_jsxs(_components.blockquote,{children:[`\n`,_jsxs(_components.p,{children:[`Quote a current-weather call to `,_jsx(_components.code,{children:`openweather-mpp`}),` for Lisbon before paying.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Call it directly`}),` (charges nothing, but reaches the service — see the warning above):`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`5`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://mcp.live.nevermined.app/mcp`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Accept: application/json, text/event-stream\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$NVM_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"quote_service\",\"arguments\":{\"slug\":\"openweather-mpp\",\"path\":\"/openweather/current-weather\",\"body\":{\"lat\":38.72,\"lon\":-9.14}}}}'`})]}),`\n`]})})})]})}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":{"config":{},"pageMetadata":{"title":"quote_service","sidebarTitle":"Quote Service","description":"Catalog MCP tool: price one call to a service without paying it — the live, fee-inclusive total, rail, and network.","href":"/mcp/catalog-mcp/quote-service"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Arguments","slug":"arguments","depth":2,"children":[]},{"title":"Returns","slug":"returns","depth":2,"children":[]},{"title":"Quote in subscription credits","slug":"quote-in-subscription-credits","depth":2,"children":[]},{"title":"Refusals (all charge nothing)","slug":"refusals-all-charge-nothing","depth":2,"children":[]},{"title":"Try it","slug":"try-it","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/neverminedag/13bbe6de0edf6c8b/docs-analytics.js"],"subdomain":"neverminedag","siteName":"Nevermined Documentation","title":"quote_service - Nevermined Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-12T10:42:54.252Z","originalFileLocation":"mcp/catalog-mcp/quote-service.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=\"Catalog MCP tool: price one call to a service without paying it — the live, fee-inclusive total, rail, and network.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Nevermined Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/neverminedag/kfri__UAQkYRE-Ph/_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=\"/docs/mintlify-assets/_mintlify/favicons/neverminedag/kfri__UAQkYRE-Ph/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/neverminedag/kfri__UAQkYRE-Ph/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/neverminedag/kfri__UAQkYRE-Ph/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/neverminedag/kfri__UAQkYRE-Ph/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/neverminedag/kfri__UAQkYRE-Ph/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/neverminedag/kfri__UAQkYRE-Ph/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/neverminedag/kfri__UAQkYRE-Ph/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/neverminedag/kfri__UAQkYRE-Ph/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"quote_service - Nevermined Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Catalog MCP tool: price one call to a service without paying it — the live, fee-inclusive total, rail, and network.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Nevermined Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://nevermined.ai/docs/mcp/catalog-mcp/quote-service\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://neverminedag.mintlify.site/docs/_mintlify/api/og/v2?division=Catalog+MCP\u0026amp;title=quote_service\u0026amp;description=Catalog+MCP+tool%3A+price+one+call+to+a+service+without+paying+it+%E2%80%94+the+live%2C+fee-inclusive+total%2C+rail%2C+and+network.\u0026amp;theme=300627ebd0d2656e65dfe786\u0026amp;signature=fa376c1bac4b72544c2dfdc19ae978839d413233719e91d14af561e92d506b25\">\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=\"quote_service - Nevermined Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Catalog MCP tool: price one call to a service without paying it — the live, fee-inclusive total, rail, and network.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://neverminedag.mintlify.site/docs/_mintlify/api/og/v2?division=Catalog+MCP\u0026amp;title=quote_service\u0026amp;description=Catalog+MCP+tool%3A+price+one+call+to+a+service+without+paying+it+%E2%80%94+the+live%2C+fee-inclusive+total%2C+rail%2C+and+network.\u0026amp;theme=300627ebd0d2656e65dfe786\u0026amp;signature=fa376c1bac4b72544c2dfdc19ae978839d413233719e91d14af561e92d506b25\">\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=\"/docs/mintlify-assets/_mintlify/favicons/neverminedag/kfri__UAQkYRE-Ph/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Nevermined Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0f766e\">\u003clink data-mint-head rel=\"canonical\" href=\"https://nevermined.ai/docs/mcp/catalog-mcp/quote-service\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/mcp/catalog-mcp/quote-service.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://nevermined.ai/#organization\",\"name\":\"Nevermined Documentation\",\"url\":\"https://nevermined.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/neverminedag/pEEAPbhrOtjiJvrW/logo/light.svg?fit=max\u0026auto=format\u0026n=pEEAPbhrOtjiJvrW\u0026q=85\u0026s=adbff4ad34c53aed8ca307e9b12104e5\"}},{\"@type\":\"WebSite\",\"@id\":\"https://nevermined.ai/docs#website\",\"name\":\"Nevermined Documentation\",\"url\":\"https://nevermined.ai/docs\",\"publisher\":{\"@id\":\"https://nevermined.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://nevermined.ai/docs/mcp/catalog-mcp/quote-service#webpage\",\"url\":\"https://nevermined.ai/docs/mcp/catalog-mcp/quote-service\",\"name\":\"quote_service\",\"description\":\"Catalog MCP tool: price one call to a service without paying it — the live, fee-inclusive total, rail, and network.\",\"dateModified\":\"2026-11-12T10:42:54.252Z\",\"isPartOf\":{\"@id\":\"https://nevermined.ai/docs#website\"},\"breadcrumb\":{\"@id\":\"https://nevermined.ai/docs/mcp/catalog-mcp/quote-service#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://nevermined.ai/docs/mcp/catalog-mcp/quote-service#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Catalog MCP\",\"item\":\"https://nevermined.ai/docs/mcp/catalog-mcp/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"quote_service\",\"item\":\"https://nevermined.ai/docs/mcp/catalog-mcp/quote-service\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://nevermined.ai/docs/mcp/catalog-mcp/quote-service#article\",\"headline\":\"quote_service\",\"name\":\"quote_service\",\"description\":\"Catalog MCP tool: price one call to a service without paying it — the live, fee-inclusive total, rail, and network.\",\"url\":\"https://nevermined.ai/docs/mcp/catalog-mcp/quote-service\",\"mainEntityOfPage\":{\"@id\":\"https://nevermined.ai/docs/mcp/catalog-mcp/quote-service#webpage\"},\"dateModified\":\"2026-11-12T10:42:54.252Z\",\"publisher\":{\"@id\":\"https://nevermined.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://nevermined.ai/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Nevermined Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Nevermined Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/mcp/catalog-mcp/quote-service.md","siteName":"Nevermined Documentation","nav":{"global":{"anchors":[]},"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/getting-started/overview"}]},{"tab":"MCP","groups":[{"group":"Catalog MCP","pages":[{"title":"Catalog MCP: Overview","icon":"plug","href":"/mcp/catalog-mcp/overview"},{"title":"list_categories","sidebarTitle":"List Categories","href":"/mcp/catalog-mcp/list-categories"},{"title":"search_services","sidebarTitle":"Search Services","href":"/mcp/catalog-mcp/search-services"},{"title":"get_service","sidebarTitle":"Get Service","description":"Catalog MCP tool: fetch one catalog service by slug — its metadata and a requestShape describing every callable endpoint and its pay_service arguments.","href":"/mcp/catalog-mcp/get-service"},{"title":"quote_service","sidebarTitle":"Quote Service","href":"/mcp/catalog-mcp/quote-service"},{"title":"pay_service","sidebarTitle":"Pay Service","description":"Catalog MCP tool: pay for a catalog service from your spend-capped delegation and return the vendor's response. Charges real funds.","href":"/mcp/catalog-mcp/pay-service"},{"title":"route_by_intent","sidebarTitle":"Route by Intent","href":"/mcp/catalog-mcp/route-by-intent"},{"title":"setup_delegation","sidebarTitle":"Set Up Delegation","href":"/mcp/catalog-mcp/setup-delegation"},{"title":"get_payment_result","sidebarTitle":"Get Payment Result","href":"/mcp/catalog-mcp/get-payment-result"},{"title":"list_payments","sidebarTitle":"List Payments","href":"/mcp/catalog-mcp/list-payments"},{"title":"payment_summary","sidebarTitle":"Payment Summary","href":"/mcp/catalog-mcp/payment-summary"},{"title":"get_budget","sidebarTitle":"Get Budget","href":"/mcp/catalog-mcp/get-budget"},{"title":"wallet_balance","sidebarTitle":"Wallet Balance","href":"/mcp/catalog-mcp/wallet-balance"},{"title":"top_up_credits","sidebarTitle":"Top Up Credits","href":"/mcp/catalog-mcp/top-up-credits"}]},{"group":"Docs MCP","pages":[{"title":"Docs MCP Overview","icon":"book","href":"/mcp/docs-mcp/overview"},{"title":"search_nevermined_documentation","sidebarTitle":"Search Documentation","href":"/mcp/docs-mcp/search-documentation"},{"title":"query_docs_filesystem_nevermined_documentation","sidebarTitle":"Query Docs Filesystem","href":"/mcp/docs-mcp/query-docs-filesystem"},{"title":"submit_feedback","sidebarTitle":"Submit Feedback","href":"/mcp/docs-mcp/submit-feedback"}]}]},{"tab":"API","pages":[{"title":"API","href":"/api-reference/introduction"}]},{"tab":"SDK","pages":[{"title":"SDK","href":"/api-reference/typescript/installation"}]}]},"basePath":"","title":"quote_service - Nevermined Documentation","buildId":"dpl_H5KQTnCewfWWvJxA7c3bCm7MFbb6","deploymentId":"dpl_H5KQTnCewfWWvJxA7c3bCm7MFbb6","dynamics":[],"chunks":[]}