How to integrate Gift up MCP with Atomic Agent

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,500+ apps through Composio, including Gift up.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Gift up account. See the Atomic Agent documentation for installation instructions.

How Atomic Agent connects to Gift up

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Gift up to Atomic Agent

1. Sign up or sign in to the Composio dashboard. Copy your API key.
2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
3. Ask Atomic Agent to do something in Gift up. It searches Composio for the right tool.
4. On first use, open the sign-in link returned in the chat. Connect your Gift up account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

The Gift up MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Gift Up! account. It provides structured and secure access to your gift card operations, so your agent can list available gift cards, fetch company or checkout details, generate transaction reports, and manage users or webhook subscriptions on your behalf.

• Gift card inventory management: Instantly list, filter, and audit all gift cards issued or available in your account, including status and details.
• Sales item and group retrieval: Let your agent fetch all items for sale and organize them by item groups, making it easy to manage or present products.
• Company and checkout settings access: Retrieve current company details and checkout configuration to audit or display your store's gift card setup.
• Transaction reporting and analytics: Generate and filter transaction reports for deep insights into gift card sales, redemptions, and trends.
• User and webhook management: List all users with account access or subscribe to webhook events, enabling automated notifications and streamlined team management.

Use Gift up from Atomic Agent

With your account connected, ask Atomic Agent to work with Gift up in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.