Gift Up! MCP server
51 operations0 webhooks
Digital and physical gift card management, issuance, redemption, orders, and balances.
Try Gift Up! with your agent
Connect Gift Up!, 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 Gift Up! on my account, then run one read-only example and show me the result.
Gift Up! tools and triggers
Tools are what your agent can do in Gift Up! through Corsair's MCP server. Triggers are the Gift Up! events a routine can start from.
Gift Cards
- GetRead-only
Retrieve details and remaining balance of a gift card by code
giftCards.get
- ListRead-only
List gift cards with status, date, order, SKU and email filters; returns giftCards with total and hasMore
giftCards.list
- ReactivateWrite
Reactivate a previously voided gift card
giftCards.reactivate
- RedeemDestructive
Redeem an amount or units against a gift card balance
giftCards.redeem
- Redeem In FullDestructive
Redeem the entire remaining balance of a gift card
giftCards.redeemInFull
- Top UpDestructive
Add currency or units to a gift card balance (issues new spendable value)
giftCards.topUp
- Transfer BalancesDestructive
Transfer remaining balances from source gift cards to a destination gift card
giftCards.transferBalances
- Undo RedemptionDestructive
Reverse a previous redemption, adding the redeemed balance back to the gift card
giftCards.undoRedemption
- UpdateWrite
Update gift card properties using JSON Patch
giftCards.update
- VoidDestructive
Void a gift card to prevent further redemptions
giftCards.void
Settings
- Delete ArtworkDestructive
Delete uploaded gift card design artwork by ID
settings.deleteArtwork
- Get CheckoutRead-only
Get company checkout styling, tips, and service fee settings
settings.getCheckout
- Get EmailRead-only
Get email branding, sender, and template settings
settings.getEmail
- Get Gift CardRead-only
Get gift card barcode, expiry, and terms defaults
settings.getGiftCard
- Get ShippingRead-only
Get physical shipping and postal delivery options
settings.getShipping
- List ArtworkRead-only
List uploaded gift card design artwork
settings.listArtwork
- Update CheckoutWrite
Update checkout settings using JSON Patch
settings.updateCheckout
- Update EmailWrite
Update email settings using JSON Patch
settings.updateEmail
- Update Gift CardWrite
Update gift card settings using JSON Patch
settings.updateGiftCard
- Upload ArtworkDestructive
Upload gift card artwork from a URL or data URI; replaceAllExistingArtwork deletes all existing artwork first
settings.uploadArtwork
Orders
- Add NoteWrite
Add an internal note to an order
orders.addNote
- CreateDestructive
Create an order and issue its gift cards. Live mode charges the Gift Up fee; recipientDetails makes Gift Up email the gift card unless disableAllEmails is true
orders.create
- GetRead-only
Retrieve details of a specific order by ID
orders.get
- ListRead-only
List orders filtered by creation date, purchaser email or source; returns orders with total and hasMore
orders.list
- Mark As PostedWrite
Mark a postal order as posted and update gift card codes
orders.markAsPosted
- UpdateWrite
Update order properties using JSON Patch
orders.update
Groups
- CreateWrite
Create a new item group
groups.create
- DeleteDestructive
Delete an item group
groups.delete
- GetRead-only
Retrieve details of an item group by ID
groups.get
- ListRead-only
List all item groups
groups.list
- UpdateWrite
Update an item group using JSON Patch
groups.update
Items
- CreateWrite
Create a new gift card item product
items.create
- DeleteDestructive
Delete a gift card item product
items.delete
- GetRead-only
Retrieve details of an item by ID
items.get
- ListRead-only
List gift card items with optional group filter
items.list
- UpdateWrite
Update item properties using JSON Patch
items.update
Users
- DeleteDestructive
Delete a staff user account
users.delete
- GetRead-only
Retrieve user details by ID
users.get
- InviteDestructive
Invite a staff user or administrator
users.invite
- ListRead-only
List staff users and administrators
users.list
- UpdateWrite
Update staff user details using JSON Patch
users.update
Integrations
- Get Stripe ConnectionRead-only
Get Stripe integration connection status and enabled payment methods
integrations.getStripeConnection
- Update Stripe ConnectionDestructive
Change Stripe payment settings for the checkout and return the connection test result
integrations.updateStripeConnection
Ping
- GetRead-only
Test connectivity and authorization with the Gift Up! API
ping.get
- PostWrite
Echo test with the Gift Up! API returning the posted payload
ping.post
Reports
- Get TransactionRead-only
Retrieve a specific ledger report transaction by ID
reports.getTransaction
- List TransactionsRead-only
List ledger transactions filtered by date range, event type, user, location or code; returns transactions with total and hasMore
reports.listTransactions
Company
- GetRead-only
Retrieve current company account profile and settings
company.get
Locations
- ListRead-only
List all company store locations
locations.list
Partners
- Create AccountDestructive
Provision a new Gift Up account for another business owner (Partner API, pre-approved partners only)
partners.createAccount
Promotions
- ListRead-only
List all active and scheduled checkout promotions
promotions.list
Connect Gift Up! to Claude, ChatGPT or Cursor
- 1
Connect Gift Up! in Corsair
Add your Gift Up! API key once in Corsair. Corsair stores the credential encrypted and makes the Gift Up! API calls for your agent, so it never goes into a prompt or a config file. Connect Gift Up!
If your link lets the agent add apps, you can skip this: it gives you a sign-in link the first time it needs Gift Up!. On a ChatGPT personal plan, connect Gift Up! 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, Gift Up!'s read and write operations run right away and its 15 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/giftup, add the Gift Up! plugin, and connect with an API key. Then call methods like corsair.giftup.api.company.get() from your app. Corsair keeps each tenant isolated.
Yes. Gift Up! requires an API key from your Gift Up! 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 Gift Up!, GitHub, Notion, Stripe, and the rest. Trigger Gift Up! from a webhook, push updates to Slack, or chain actions across plugins. Same tenant context across integrations, plain TypeScript.
Teams use Corsair for digital and physical gift card management, issuance, redemption, orders, and balances. Common builds include sync jobs, admin tooling, and agents that call Gift Up! 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 Gift Up! 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/giftup in the open repo. When Gift Up! 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 Gift Up! data or hold individual access credentials. Credentials stay in your database. API calls run on your instance. We do not store Gift Up! 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 Gift Up! 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 15 destructive Gift Up! operations. You can change a link's mode at hub.corsair.dev/me.