Ask Pikt · Connector docs

Ask Pikt connector docs

Learn how to connect Pikt to an AI agent and what the connection allows. Pikt names the card in your wallet that is likely to earn the most. It never sees card numbers or moves money.

Back to Ask Pikt

At a glance

Ask Pikt is a remote MCP connector. Once it is connected, your agent can ask Pikt which of your cards fits a purchase, list the cards in your Pikt wallet, and list offers that match them. It is read-only: it cannot pay, move money, turn on an offer, or change your Pikt account.

Server address: https://www.trypikt.com/api/member-mcp/mcp
Transport: Streamable HTTP, POST only, stateless (no session to keep open). The address is the same for everyone and holds no key.
Sign-in: OAuth 2.1 authorization code with PKCE (S256), through Pikt sign-in. Dynamic client registration is supported, so most agents register themselves.
Scope: profile only. No scope reaches card data; Pikt looks up the wallet of whoever signed in.
Discovery: https://www.trypikt.com/.well-known/oauth-protected-resource/api/member-mcp/mcphttps://www.trypikt.com/.well-known/oauth-authorization-server/api/member-mcp/mcp
Access: Read-only: three tools and one resource, listed below.
Who can use it: Anyone with a free Pikt account and at least one card added. Pikt is in beta, for U.S. residents 18 and older. Pikt Pro is not required.
Server version: 0.4.0

Before you connect

A Pikt account with at least one card in your wallet. Cards are added by name, never by number.
An agent that supports remote MCP connectors with OAuth sign-in, such as Claude, ChatGPT, or Cursor. On a team or company plan, an admin may need to allow custom connectors first.
A computer for setup. After that, your agent decides which of its apps can use Pikt.

Connect your agent

Add Pikt with the server address above, then sign in with your Pikt account when your agent asks. That sign-in is how Pikt knows which wallet to use.

Claude

Open Connectors. In Claude on a computer, open Settings, then Connectors. On a Team or Enterprise plan, an owner may need to enable the connector under Organization connectors first.
Add Pikt. Choose Add custom connector. Enter Pikt as the name and put Pikt's connection address in the MCP server URL field. Leave Sign in now and Register automatically selected, then click Add. Complete the Pikt sign-in when Claude opens it.
Enable Pikt for a chat. Click Connect next to Pikt and sign in. Open a Claude chat, enable Pikt, and confirm it appears in the tools list. Use /pikt for a general request, or /which-card, /my-cards, or /my-offers for a specific request. Do not type /pikt into a Claude Code terminal. If Claude does not offer the slash command, select Pikt from the tools list and ask in plain words. Review any tool approval before allowing it.

The /pikt command works in Claude Chat after Pikt is connected and enabled. Claude Code may show Unknown command instead. Claude may also ask you to approve a tool call.

ChatGPT

Open ChatGPT Plugins

One beta setting to change

Open Advanced OAuth settings and turn off OIDC enabled before you create the app. Leave Default scopes set to profile. If ChatGPT shows invalid_scope or mentions openid, remove the unfinished app and repeat this step with OIDC off.

Open the Plugins page. Use the button above in ChatGPT on the web. Select +, choose Create app, then choose Create MCP App. If Create app is missing, open Settings → Plugins → Developer mode; the switch is under Security and login and may be controlled by a workspace admin.
Create Pikt. Enter Pikt as the name, paste Pikt's connection address into Server URL, and keep Authentication set to OAuth. Expand Advanced OAuth settings. Keep Dynamic Client Registration and the profile default scope, then turn off OIDC enabled. Acknowledge ChatGPT's custom-app warning, choose Create, and finish the Pikt sign-in.
Ask in plain words. After Pikt is connected, start a normal Chat (not Work) and confirm Pikt is available in that chat from the Plugins or tools picker. Then type @Pikt followed by your question. ChatGPT uses @Pikt; do not use the Claude or Cursor slash commands here. If ChatGPT says Pikt is unavailable, return to the picker and reconnect or enable it before retrying. An installed Pikt listing alone does not make the app callable.

On a managed workspace, an admin may need to enable or publish the app. Pikt can appear under Installed while still being unavailable in a chat, so confirm it is enabled before asking.

Cursor

Open MCP settings. In Cursor, open Customize and choose MCPs. Click New MCP Server (Add a Custom MCP Server), then choose User to open ~/.cursor/mcp.json, or choose your workspace to keep Pikt in that workspace only.
Add Pikt. Paste the Pikt JSON snippet shown here into the file and save it. This is a remote Streamable HTTP server, so you do not need to run a local command.
Enable Pikt for the chat. Save the MCP file, then click Connect or Login next to Pikt if Cursor shows it and complete sign-in. If the old Pikt entry says the link is no longer connected, open New MCP Server and create a fresh connection. Enable Pikt from the chat's MCP tools list. Use /pikt for a general request, or /which-card, /my-cards, or /my-offers for a specific request. If Cursor does not offer the slash command, select Pikt from the tools list and ask in plain words. Review Cursor's approval request before allowing a tool call.

{
  "mcpServers": {
    "pikt": {
      "url": "https://www.trypikt.com/api/member-mcp/mcp"
    }
  }
}

Cursor may ask for approval before using an MCP tool. Review the request before allowing it. If Pikt shows Needs attention, says the link is no longer connected, or times out, create a fresh connection before asking again.

Another agent

Any agent that supports remote MCP over streamable HTTP with OAuth can use Pikt. Add a custom connector with the server address above, leave sign-in on OAuth, and complete the Pikt sign-in it opens. Agents that read the discovery documents find the sign-in details on their own.

If your agent asks for a key instead

Some agents cannot sign in and want a key. Signed-in members can create a private link on the Ask Pikt page in Pikt. It carries a key inside the address, so treat it like a password and add it only in your agent's connector settings, never in a chat.

Tools

This list is read from the live Pikt server, so it always matches what your agent sees after connecting. Every tool is marked read-only.

Which card

which_cardRead-only

Names the card in the member's Pikt wallet with the highest estimated earn for a purchase at a store, with a short reason, the estimated earn of the member's other cards, any matching issuer offer, and a card-acceptance estimate when the purchase is in another country. Use it when the member asks which card to use for a purchase. Takes the store name, plus the amount in USD, store website, merchant category code, country code, and US ZIP code when known. Results cover only cards in the member's Pikt wallet.

Inputs

merchant (string, required) — Merchant or store name, e.g. Sweetgreen
amount (number, optional) — Purchase amount in USD when known. Omit if unknown; never guess or convert currency.
domain (string, optional) — Merchant website domain or URL when known
mcc (string or integer, optional) — Four-digit merchant category code when known
countryCode (string, optional) — Two-letter country code for the purchase location, such as "IT". Send it when the purchase is abroad. This controls card acceptance checks, not currency conversion.
zipCode (string, optional) — US ZIP code when known

My cards

my_cardsRead-only

Lists every card in the member's Pikt wallet: display name, issuer, whether it is the default card, card color, wallet label, and headline earn rates by category. Use it when the member asks which cards they have in Pikt. The list is the complete wallet.

Inputs

No inputs.

My offers

my_offersRead-only

Lists live issuer offers that match cards in the member's Pikt wallet, optionally for one store: the reward, the card, the issuer app where the offer is managed, the end date, a confidence level, an estimated dollar amount for each offer, and whether the offer must be activated in the issuer's app before it pays. Use it when the member asks which offers are available across their wallet or at a store.

Inputs

merchant (string, optional) — Optional store name to filter live offers

Resource

pikt://wallet

The member's Pikt wallet: the complete list of cards they carry, the same list my_cards returns.

Example questions

Name the store, the amount if you know it, and the country when you pay abroad. Pikt only names cards already in your Pikt wallet, and every answer is an estimate: your card issuer decides what a purchase earns.

“I’m grabbing a $24 lunch at Sweetgreen — which card should I use, and why?”
“I’m spending about $180 at Whole Foods — which card wins, and what offers should I check?”
“Before I spend $3,200 on a MacBook at Apple, which card in my wallet is strongest?”
“I’m booking a $2,400 United trip to Italy — which card should I use, and what offers are live?”
“I’m packing for a two-week trip — show me every card in my Pikt wallet so I know what I carry.”

What Pikt shares

What your agent can get from Pikt

The names and issuers of the cards in your wallet, which one is your default, their colors and wallet labels, and their headline earn rates by category.
For a purchase you ask about: the card Pikt names, a short reason, the category, estimated rewards for that card and your other cards, and how confident Pikt is.
Offers from Pikt's list that match your cards, to check and turn on in your issuer's app.
Pikt's own reference numbers for your cards and for the answer. They are labels Pikt made up, not card numbers.

What it never returns

Card numbers (full or partial), expiry dates, security codes, bank logins, account or routing numbers, balances, credit limits, or your transaction history.

What your agent sends Pikt

The store name and, when it has them, the amount, the store's website, the merchant category code, the country, and a U.S. ZIP code. Pikt does not receive the rest of your conversation with the agent.

Once Pikt answers, the company that runs your agent handles that answer under its own privacy policy, not Pikt's.

Agents that can buy things

Some agents can shop or pay for you with their own payment tools. Pikt is not part of that payment. Here is how the pieces fit:

Connect
You add Pikt to your agent and sign in. Pikt can now read your wallet for that agent, and nothing else.
Ask
Your agent asks Pikt about the purchase. Pikt names a card and gives the reason. The answer is labeled a recommendation for you to confirm, never an instruction to pay.
You decide and pay
What happens next is between you and your agent. An agent that can pay does so through its own payment provider, under its own approval rules. Pikt never sees payment details and never approves anything.
Nothing comes back
Pikt is not told whether a purchase happened or which card was used. If that ever changes, it will be described here and in the Privacy Policy, and you will be asked first.

If Pikt is unavailable or cannot answer, your agent gets no recommendation from Pikt and the choice of card stays with you. Pikt never chooses a card for you without saying so.

Errors and limits

Pikt returns errors your agent can pass on as written, so you know what to do next.

What happened	What your agent gets	What to do
Not signed in, or the sign-in expired	HTTP 401 with a `WWW-Authenticate` header pointing at the discovery document	Your agent should send you to sign in to Pikt again.
You disconnected this agent in Pikt	HTTP 403, code -32003: “You disconnected this agent from Pikt. To use it again, open Ask Pikt in Pikt, choose Allow again, then reconnect Pikt here.”	Choose Allow again on the Ask Pikt page, then sign in from the agent if it asks.
Too many requests	HTTP 429, code -32029, with a Retry-After header. The limit is 60 requests a minute per member.	Wait a minute and ask again.
No cards in your Pikt wallet	A tool error: “No cards in your Pikt wallet yet. Add a card in Pikt, then ask again.”	Add a card in Pikt, then ask again.
Pikt could not answer in time	A tool error: “Pikt could not check right now. Try again in a moment.”	Ask again in a moment.
No purchase amount was given	An answer marked provisional, with a note asking for the amount in USD. Dollar estimates are left out.	Tell your agent the amount.
A private link was turned off	HTTP 200 with JSON-RPC code -32001: “This link is no longer connected. Create a new one in Pikt Settings.”	Create a new link on the Ask Pikt page, or switch to signing in.
Ask Pikt is switched off during the beta	HTTP 404	Check back later; Card Check in Pikt keeps working.

Disconnecting

On the Ask Pikt page in Pikt, Disconnect everything turns off your private link and every agent you signed in to Pikt from, at once. You can also disconnect one agent at a time. A disconnected agent is refused on its very next request, and Pikt also cancels its sign-in with our sign-in provider where that provider allows it.

A disconnected agent stays blocked, even if you sign in to Pikt from it again, until you choose Allow again for it on the Ask Pikt page. Then sign in from the agent once more if it asks. Removing Pikt in your agent's own settings also stops that agent from asking.

An agent shows up on the Ask Pikt page the first time it asks Pikt something. Deleting your Pikt account ends every connection.

Privacy, terms, and support

The Privacy Policy and Terms of Service cover connected agents in their own sections.

Privacy Policy, Section 1f
What a connected agent can see, what it sends, and how connections end
Terms of Service, Section 5b
Pikt advises and you decide; agent payments are the agent's own
Security
How Pikt protects your account and data

Support

Questions, a connector that will not connect, or a security concern: email us or use the contact form. Include which agent you use and the error text if you have it.

[email protected]Contact form

What happened

What your agent gets

What to do

Not signed in, or the sign-in expired

HTTP 401 with a WWW-Authenticate header pointing at the discovery document

Your agent should send you to sign in to Pikt again.

You disconnected this agent in Pikt

HTTP 403, code -32003: “You disconnected this agent from Pikt. To use it again, open Ask Pikt in Pikt, choose Allow again, then reconnect Pikt here.”

Choose Allow again on the Ask Pikt page, then sign in from the agent if it asks.

Too many requests

HTTP 429, code -32029, with a Retry-After header. The limit is 60 requests a minute per member.

Wait a minute and ask again.

No cards in your Pikt wallet

A tool error: “No cards in your Pikt wallet yet. Add a card in Pikt, then ask again.”

Add a card in Pikt, then ask again.

Pikt could not answer in time

A tool error: “Pikt could not check right now. Try again in a moment.”

Ask again in a moment.

No purchase amount was given

An answer marked provisional, with a note asking for the amount in USD. Dollar estimates are left out.

Tell your agent the amount.

A private link was turned off

HTTP 200 with JSON-RPC code -32001: “This link is no longer connected. Create a new one in Pikt Settings.”

Create a new link on the Ask Pikt page, or switch to signing in.

Ask Pikt is switched off during the beta

HTTP 404

Check back later; Card Check in Pikt keeps working.

Ask Pikt connector docs

At a glance

Before you connect

Connect your agent

Claude

ChatGPT

Cursor

Another agent

If your agent asks for a key instead

Tools

Which card

My cards

My offers

Resource

Example questions

What Pikt shares

What your agent can get from Pikt

What it never returns

What your agent sends Pikt

Agents that can buy things

Connect

Ask

You decide and pay

Nothing comes back

Errors and limits

Disconnecting

Privacy, terms, and support

Support

Ask Pikt connector docs

At a glance

Before you connect

Connect your agent

Claude

ChatGPT

Cursor

Another agent

If your agent asks for a key instead

Tools

Which card

My cards

My offers

Resource

Example questions

What Pikt shares

What your agent can get from Pikt

What it never returns

What your agent sends Pikt

Agents that can buy things

Connect

Ask

You decide and pay

Nothing comes back

Errors and limits

Disconnecting

Privacy, terms, and support

Support