Poke connects with a plain Nevermined API key, not the OAuth “approve a spending cap” flow that some assistants (Claude, ChatGPT) use. The key is your credential — it spends whatever its Nevermined account funds, so you set the budget on your account, not in Poke.
Before you connect
1
A Nevermined account
Free, at nevermined.app.
2
A Nevermined API key
Create a plain API key in the app — Settings → Global NVM API Keys — for the environment you want, and send the whole string, prefix included (
sandbox:… or live:…). A key minted by an OAuth flow can’t pay through the Router’s delegation routes, so use a plain one. See Get a Nevermined API key.3
A way to pay
The key spends from one of two budgets you set up once: a Nevermined Subscription whose monthly credits a plain key can spend, or a spending delegation — a capped, revocable budget funded from your own wallet (Using the Catalog from a harness walks through it). Discovery is free and needs neither.
Start on sandbox, where you use testnet funds and nothing costs real money, before you point Poke at live.
Add the Catalog to Poke
1
Create an integration
Open poke.com/integrations/new, give it a Name, and set MCP Server URL to the environment you want:
2
Add your API key
Paste your Nevermined API key into the API Key field and click Create Integration — Poke includes it as an
Authorization header on every request to the server.CLI alternative: npx poke@latest mcp add https://mcp.live.nevermined.app/mcp -n "nevermined-catalog" -k "<your Nevermined API key>".Your Nevermined API key
That key is your credential — there is no separate consent screen to approve. Keep the prefix: alive: key for mcp.live, a sandbox: key for mcp.sandbox.
The key spends whatever its account funds — your Subscription credits, or a spending delegation funded from your wallet — so the budget and the audit trail live on your Nevermined account, not in Poke. Treat it like a password: never commit it or paste it into a shared chat. Every way to mint one: Get a Nevermined API key.
Make your first paid call
Ask for something only live data can answer, and name the integration so Poke reaches for it rather than answering from memory.1
Browse for free
Message Poke “list the Nevermined catalog categories” — a free tool call, no payment.
2
Ask it to buy
“Buy the service with slug
<slug> through the Nevermined integration and show me the response.” The paid call draws on your subscription credits or delegation and returns the merchant’s response.Disconnect or rotate the key
- Stop the credential (Nevermined side). The key is the credential, so to cut Poke off, rotate or delete the key in the app (Settings → Global NVM API Keys) — every call with the old key then fails. To cap spending without revoking the key, revoke the delegation it spends from in Payment methods; discovery still works.
- Remove the server (Poke side). Delete the Nevermined integration from your Poke integrations.
Next
Using the Catalog from a harness
The full plain-key playbook — discovery, delegations, and the safety rules.
Catalog MCP — full reference
Every tool, the API-key header, and every refusal code.