Fidel API MCP server

Connect Fidel API to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Fidel API MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the create webhook tool in Fidel API
  • Use the list programs tool in Fidel API
  • Use the list cards tool in Fidel API
  • Use the list locations tool in Fidel API
  • Use the delete brand tool in Fidel API
  • Use the delete location tool in Fidel API

Supported Tools

create_webhook

Create Webhook

Creates a new webhook subscription for a specific event type in a Program. When the event occurs, Fidel API sends an HTTP POST to the specified URL. Use an HTTPS destination. Brand consent and offer-location events are account-scoped; program events use the supplied Program.

list_programs

List Programs

Lists all Programs in your Fidel API account. Supports pagination to navigate through large sets of programs.

list_cards

List Cards

Lists all enrolled cards in a specific Program. Returns card tokens, schemes, and metadata for each enrolled card.

list_locations

List Locations

Lists all Locations in a specific Program. Returns locations with their addresses, statuses, and onboarding information.

delete_brand

Delete Brand

Deletes a Brand from your Fidel API account. This is a destructive action that cannot be undone.

delete_location

Delete Location

Deletes a Location from a Program. This is a destructive action that cannot be undone and will stop transaction tracking at this location.

get_program

Get Program

Retrieves details of a specific Program by its ID, including its name, status, and metadata.

get_card

Get Card

Retrieves details of a specific enrolled card by its ID. Returns the card's token, scheme, last digits, and metadata.

delete_card

Delete Card

Unlinks and deletes an enrolled card from a Program. The card network will stop sending transactions for this card. This action cannot be undone.

create_program

Create Program

Creates a new Program in Fidel API. A Program is the parent object of the card-linked structure that groups locations, cards, webhooks, and transactions. Use this to set up a new loyalty or rewards scheme.

update_program

Update Program

Updates an existing Program's name or metadata.

update_webhook

Update Webhook

Updates an existing webhook's URL or event type.

get_transaction

Get Transaction

Retrieves details of a specific transaction by its ID. Returns the full transaction record including amount, currency, card details, merchant info, and any offer qualification data.

create_brand

Create Brand

Creates a new Brand in Fidel API. Brands aggregate different locations that a brand operates at for transaction tracking. Brands are shared across Programs.

enroll_card

Enroll Card

Enrolls a payment card in a Fidel API Program. The card is verified with the associated card network and a token is created to represent it. Requires PCI compliance for direct API enrollment.

manage_offer_locations

Link/Unlink Offer Location

Links or unlinks a Location to/from an Offer. Linking a location makes transactions at that location eligible for the offer. Unlinking removes the eligibility.

delete_webhook

Delete Webhook

Deletes a webhook subscription from a Program. The endpoint will stop receiving notifications for the associated event.

manage_offer_card

Activate/Deactivate Offer on Card

Activates or deactivates an Offer on a specific Card. Activating makes the card eligible for the offer's rewards. Deactivating removes the card's eligibility.

create_test_transaction

Create Test Transaction

Creates a test transaction for development and testing purposes. Only works in test mode. Simulates a payment at a specific location with a linked card.

get_brand

Get Brand

Retrieves details of a specific Brand by its ID.

list_brands

List Brands

Lists all Brands in your Fidel API account. Brands are shared across programs and represent the business entities whose transactions are tracked.

list_transactions

List Transactions

Lists transactions for a Program or a specific Card. Supports filtering by date range. Returns authorization, clearing, and refund events with full transaction details.

get_offer

Get Offer

Retrieves details of a specific Offer by its ID, including its type, value, status, and date range.

get_location

Get Location

Retrieves details of a specific Location by its ID, including its address, status, and onboarding information.

update_brand

Update Brand

Updates an existing Brand's logo, website, or metadata. The legacy name field is retained, but name changes are not documented by Fidel.

list_webhooks

List Webhooks

Lists all webhooks configured for a specific Program. Returns each webhook's event type, URL, and configuration.

create_offer

Create Offer

Creates a card-linked Offer for a Brand. Link locations with manage_offer_locations or link_all_offer_locations to make it eligible in a Program. Offers can be fixed-amount cashback or percentage-based discounts. When a qualifying transaction occurs at a linked location, the offer is applied automatically.

create_location

Create Location

Creates a new Location under a Program for a specific Brand. Locations represent physical or online stores identified by Merchant IDs (MIDs) where transactions from linked cards will be tracked.

update_offer

Update Offer

Updates an existing Offer's name, date range, max reward, or metadata.

list_offers

List Offers

Lists all Offers in a specific Program. Returns offer details including type, value, status, and linked brands.

create_missing_transaction_request

Create Missing Transaction Request

Ask the card network to investigate a missing transaction for a linked card at a known location.

list_cards_by_metadata

List Cards by Metadata ID

Find enrolled cards across programs using their metadata.id index, for customer reconciliation.

update_card_metadata

Update Card Metadata

Replace the metadata on an enrolled card. Send an empty object to clear its metadata.

list_offer_locations

List Offer Locations

List the merchant locations linked to an offer and their onboarding details.

get_missing_transaction_request

Get Missing Transaction Request

Retrieve a missing transaction investigation and any network result.

list_offer_cards

List Cards with Active Offer

List cards on which an offer is activated.

update_location

Update Location

Update a merchant location address, metadata, or known merchant IDs. Supply the complete address as required by Fidel.

check_offer_card

Check Active Offer on Card

Check whether an offer is active on a card, without changing its activation.

delete_offer

Delete Offer

Delete a self-sourced offer created by a publisher. Marketplace and content-provider offers cannot be deleted.

get_webhook

Get Webhook

Retrieve an account or program webhook by its ID, including its URL, event, and verification secret.

list_missing_transaction_requests

List Missing Transaction Requests

List missing transaction investigations in a program, optionally filtering by card, location, brand, or status.

Connect Fidel API to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Fidel API in Metorial. In your Metorial portal, enable the Fidel API MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Fidel API tools.

Run Fidel API through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Fidel API and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Fidel API tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Fidel API

Mailchimp

Manage email marketing audiences, campaigns, and automations. Create, send, schedule, and track email campaigns with detailed reporting on opens, clicks, and bounces. Add, update, and organize audience contacts with tags, segments, and interest groups. Set up and manage automation workflows triggered by subscriber activity or events. Connect e-commerce stores to manage customers, products, orders, and carts. Create and manage reusable email templates and landing pages. Upload and organize files for use in campaigns. Send transactional emails via the Mandrill API. Post custom events to trigger targeted automations. Configure webhooks to track subscribe, unsubscribe, profile updates, and email delivery events.

Zoho

Manage Zoho CRM, Bigin, Books, Inventory, Invoice, Desk, Mail, People, and Projects from one connection. Discover organizations and accounts, manage records and financial documents, work with support tickets and email, and organize employee and project data.

Quickbooks

Manage business finances and accounting in QuickBooks Online. Create, send, and track invoices. Manage bills and accounts payable, record bill payments. Create and update customer and vendor records with contact details and hierarchies. Record payments against invoices and credit memos. Create estimates, sales receipts, and journal entries. Track expenses and categorize against the chart of accounts. Manage items, products, services, and inventory levels. Query entities using SQL-like syntax and sync incremental changes via Change Data Capture. Generate financial reports including profit and loss, balance sheet, and cash flow. Process credit card and bank account (ACH) payments via the Payments API. Manage the chart of accounts for tracking income, expenses, assets, and liabilities.

Square

Process payments, manage orders, and handle invoices for online, in-app, and in-person commerce. Create and manage customer profiles, catalog items, inventory counts, and locations. Issue refunds, manage disputes, and track payouts. Create bookings and appointments, manage team members and timecards, handle gift cards and loyalty programs, and manage subscriptions. Save cards on file, generate checkout links, connect and control Square Terminal devices, and manage vendor/supplier information. Extend Square objects with custom attributes. Receive webhook notifications for payments, orders, customers, inventory, invoices, bookings, disputes, team changes, and more.

Gumroad

Manage digital and physical product sales on Gumroad. View and update product metadata, create and manage variant categories and options, and configure discount offer codes. Retrieve and filter sales data by date range for reporting. Manage subscribers and subscription lifecycles for recurring products. Refund sales, revoke or restore buyer access, and track payouts. Verify, enable, disable, and decrement license keys for purchase validation. Draft, schedule, and send audience emails to customers and followers. Read product reviews and access authenticated user profile information.

Stripe

Process payments, manage subscriptions, and handle invoices. Create and manage customers, payment methods, and product catalogs. Issue refunds, handle disputes, and submit chargeback evidence. Create checkout sessions and payment links. Manage connected accounts and platform fund flows via Stripe Connect. Configure payouts to bank accounts and debit cards. Apply coupons and promotion codes to subscriptions and invoices. Calculate and collect taxes automatically. Access balance information and transaction history. Upload files for dispute evidence and identity verification. Create and manage virtual and physical payment cards via Issuing. Receive real-time webhook notifications for payment, subscription, invoice, and account events.

Technical notes for Fidel API

Link payment cards to programs and monitor transactions in real-time across Visa, Mastercard, and American Express networks. Manage programs, brands, and locations for card-linked loyalty and rewards schemes. Enroll cards via API or SDKs, track authorization, clearing, and refund transaction events via webhooks. Create and manage card-linked offers with configurable cashback or discount rewards. Configure webhooks for transaction, card, brand, location, and program status events.

Frequently asked questions

Common questions about connecting Fidel API to AI agents with Metorial.

  1. How many tools does the Fidel API MCP server have?
    The Fidel API MCP server exposes 42 tools, including Create Webhook, List Programs, List Cards. Each one is governed and traced through Metorial.
  2. Fidel API exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Fidel API MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Fidel API and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Fidel API MCP server yourself or use the hosted gateway.

Connect Fidel API to production AI agents

See how Metorial gives your team governed access to Fidel API, with tracing and security controls built in.