Fidel MCP server
55 operations0 webhooks
Card-linking API for linking consumer payment cards to programs and offers, exposing cards, transactions, programs, brands, locations, offers, and webhooks operations.
Try Fidel with your agent
Connect Fidel, then paste this into Claude, ChatGPT or Cursor. For ideas from other apps, see the use cases.
Using Corsair, show me what you can do in Fidel on my account, then run one read-only example and show me the result.
Fidel tools and triggers
Tools are what your agent can do in Fidel through Corsair's MCP server. Triggers are the Fidel events a routine can start from.
Offers
- Activate Offer On CardWrite
Activate an offer on a linked card
offers.activateOfferOnCard
- Create OfferWrite
Create an offer on Fidel
offers.createOffer
- Delete OfferDestructive
Delete an offer from Fidel
offers.deleteOffer
- Link All Brand Locations To OfferWrite
Link every location of a brand in a program to an offer
offers.linkAllBrandLocationsToOffer
- Link Location To OfferWrite
Link a location to an offer
offers.linkLocationToOffer
- List Cards With Active OfferRead-only
List the linked cards with an active offer
offers.listCardsWithActiveOffer
- List OffersRead-only
List the offers of a program
offers.listOffers
- Retrieve Active Offer On CardRead-only
Check whether an offer is active on a linked card
offers.retrieveActiveOfferOnCard
- Retrieve OfferRead-only
Retrieve an offer by ID
offers.retrieveOffer
- Send Offer To BrandWrite
Send an offer to its brand for approval; this notifies the brand and works only in the live environment
offers.sendOfferToBrand
- Unlink Card From OfferDestructive
Deactivate an offer on a linked card and reset its usage
offers.unlinkCardFromOffer
- Unlink Location To OfferDestructive
Unlink a location from an offer
offers.unlinkLocationToOffer
- Update OfferWrite
Update the details of an offer
offers.updateOffer
Locations
- Create LocationWrite
Create a location under a program and brand
locations.createLocation
- Delete LocationDestructive
Delete a location from a program
locations.deleteLocation
- List LocationsRead-only
List the locations of a program
locations.listLocations
- List Locations By BrandRead-only
List the locations of a brand within a program
locations.listLocationsByBrand
- List Locations By OfferRead-only
List the locations linked to an offer
locations.listLocationsByOffer
- Retrieve LocationRead-only
Retrieve a location by ID
locations.retrieveLocation
- Update LocationWrite
Update the details of a location
locations.updateLocation
Webhooks
- Create Brand WebhookWrite
Create a webhook for brand events on Fidel
webhooks.createBrandWebhook
- Create Program WebhookWrite
Create a webhook for program events on Fidel
webhooks.createProgramWebhook
- Delete WebhookDestructive
Delete a webhook from a program
webhooks.deleteWebhook
- List WebhooksRead-only
List the webhooks of a program
webhooks.listWebhooks
- Retrieve WebhookRead-only
Retrieve a webhook by ID
webhooks.retrieveWebhook
- Update WebhookWrite
Update the details of a webhook
webhooks.updateWebhook
Brands
- Create BrandWrite
Create a brand on Fidel
brands.createBrand
- Delete BrandDestructive
Delete a brand from the Fidel account
brands.deleteBrand
- List BrandsRead-only
List the brands on the Fidel account
brands.listBrands
- Retrieve BrandRead-only
Retrieve a brand by ID
brands.retrieveBrand
- Update BrandWrite
Update the details of a brand
brands.updateBrand
Cards
- Delete CardDestructive
Remove a linked card from a program
cards.deleteCard
- List CardsRead-only
List the linked cards of a program
cards.listCards
- List Cards From Metadata IdRead-only
List the linked cards matching a metadata identifier
cards.listCardsFromMetadataId
- Retrieve CardRead-only
Retrieve a linked card by ID
cards.retrieveCard
- Update Card MetadataWrite
Replace the metadata of a linked card
cards.updateCardMetadata
Programs
- Create ProgramWrite
Create a program on Fidel
programs.createProgram
- List ProgramsRead-only
List the programs on the Fidel account
programs.listPrograms
- Retrieve ProgramRead-only
Retrieve a program by ID
programs.retrieveProgram
- Update ProgramWrite
Update the details of a program
programs.updateProgram
Transactions
- Create Transaction TestWrite
Create a test transaction in the test environment
transactions.createTransactionTest
- List TransactionsRead-only
List the transactions of a program
transactions.listTransactions
- List Transactions By CardRead-only
List the transactions of a linked card
transactions.listTransactionsByCard
- Retrieve TransactionRead-only
Retrieve a transaction by ID
transactions.retrieveTransaction
Mid-Requests
- Create Mid RequestWrite
Create a MID request to onboard, offboard or reassign a merchant ID; offboarding stops transaction tracking for that MID
mid-requests.createMidRequest
- List Mid RequestsRead-only
List the MID requests of a program
mid-requests.listMidRequests
- Retrieve Mid RequestRead-only
Retrieve a MID request by ID
mid-requests.retrieveMidRequest
Missing-Transaction-Requests
- Create Missing Transaction RequestWrite
Create a missing transaction request for a linked card
missing-transaction-requests.createMissingTransactionRequest
- List Missing Transaction RequestsRead-only
List the missing transaction requests of a program
missing-transaction-requests.listMissingTransactionRequests
- Retrieve Missing Transaction RequestRead-only
Retrieve a missing transaction request by ID
missing-transaction-requests.retrieveMissingTransactionRequest
Marketplace
- Create Offer From Marketplace OfferWrite
Create an offer from a marketplace offer
marketplace.createOfferFromMarketplaceOffer
- List Marketplace OffersRead-only
List the offers available in the Fidel marketplace
marketplace.listMarketplaceOffers
Mids
- List MidsRead-only
List the merchant IDs of a program
mids.listMids
- Retrieve MidRead-only
Retrieve a merchant ID of a program by ID
mids.retrieveMid
Mid-Insights
- List Mid InsightsRead-only
List the MID insights of a program
mid-insights.listMidInsights
Connect Fidel to Claude, ChatGPT or Cursor
- 1
Connect Fidel in Corsair
Add your Fidel API key once in Corsair. Corsair stores the credential encrypted and makes the Fidel API calls for your agent, so it never goes into a prompt or a config file. Connect Fidel
If your link lets the agent add apps, you can skip this: it gives you a sign-in link the first time it needs Fidel. On a ChatGPT personal plan, connect Fidel here first.
- 2
Add Corsair's MCP server to your agent
Every client uses the same address:
https://mcp.corsair.dev/mcpOpen Customize → Connectors → Add custom connector, paste the address, then select Connect.Add a custom MCP server with the address and choose OAuth. Personal plans get read tools only.Add to CursorOr add this to~/.cursor/mcp.json. Cursor opens Corsair to sign in the first time it connects.{ "mcpServers": { "corsair": { "url": "https://mcp.corsair.dev/mcp" } } }Run this, then run/mcpin Claude Code to sign in.claude mcp add --transport http corsair https://mcp.corsair.dev/mcpCodex, Gemini CLI, VS Code, Zed and other clients with OAuth sign-in work the same way. Clients without it, such as GitHub Copilot's coding agent, use a link's own address and an API key. Setup for every client
- 3
Sign in and choose what needs your approval
Your client opens Corsair to sign in. Pick a link: the apps your agent can use and a mode that decides what it may do without asking. In the default Cautious mode, Fidel's read and write operations run right away and its 7 destructive operations wait for your approval. Strict mode asks before every write and refuses destructive operations, and Read mode allows reads only.
FAQ
Install corsair and @corsair-dev/fidel, add the Fidel plugin, and connect with an API key. Then call methods like corsair.fidel.api.brands.createBrand() from your app. Corsair keeps each tenant isolated.
Yes. Fidel requires an API key from your Fidel account or developer dashboard. Create credentials with access that matches what you automate, then paste them into Corsair or connect through managed auth in Hub.
Yes. One Corsair client can hit Fidel, GitHub, Notion, Stripe, and the rest. Trigger Fidel from a webhook, push updates to Slack, or chain actions across plugins. Same tenant context across integrations, plain TypeScript.
Teams use Corsair for card-linking API for linking consumer payment cards to programs and offers, exposing cards, transactions, programs, brands, locations, offers, and webhooks operations. Common builds include sync jobs, admin tooling, and agents that call Fidel APIs from your backend.
The SDK is open source. Self-host and you pay Corsair nothing for the integration layer. Hub bills for hosted auth and execution, not per Fidel API call. Hub has a generous free tier. For hobby projects you can probably run the whole thing on free. Paid plans start to matter with more tenants or heavier traffic.
We maintain @corsair-dev/fidel in the open repo. When Fidel ships API changes, upgrade the package. Your call sites stay typed. You should not need to rewrite the integration layer each time.
No. Corsair does not read your Fidel data or hold individual access credentials. Credentials stay in your database. API calls run on your instance. We do not store Fidel data on your behalf.
Yes. Add https://mcp.corsair.dev/mcp as a custom connector or MCP server in Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex or any client that supports remote MCP servers with OAuth sign-in, then sign in to Corsair. On ChatGPT personal plans, custom servers currently get read tools only.
Yes. Put Fidel on a link in Strict mode and every write waits for your approval, while destructive actions are refused. The default Cautious mode asks only before the 7 destructive Fidel operations. You can change a link's mode at hub.corsair.dev/me.