Piggy MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Piggy MCP or direct API to automate loyalty rewards, issue cashback, track points, and engage customers through natural language.

Piggy logoPiggy
Api Key

Piggy is a loyalty and cashback platform for online stores, letting users earn points or discounts. It helps businesses boost repeat purchases and customer retention.

14 Tools

Try Piggy now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Piggy
Try asking
TOOLS

Supported Tools

Every Piggy action and event your agent gets out of the box.

Claim Anonymous Contact

Tool to claim an anonymous contact by associating it with a real email address.

Create Contact Attribute

Tool to create a custom Contact Attribute.

Create Credit Reception

Tool to create a credit reception for a contact.

Create Vouchers Batch

Tool to create a batch of vouchers for a promotion.

Find or Create Products

Tool to find an existing product by external_identifier or create a new one if it doesn't exist.

Find Voucher By Code

Tool to find a voucher by its unique code.

Get Contact Auth Token

Tool to get an auth token for a Contact.

Get Contact's Credit Balance

Tool to get a Contact's credit balance.

List Forms

Tool to list all forms in the Piggy account.

List Perks

Tool to list all available perks in Piggy.

Merge Contacts

Merges a source contact into a destination contact in Piggy's CRM.

Send Contact Verification Email

Send a verification email to a Piggy contact for identity verification.

Update Bookings

Tool to update an existing booking in Piggy.

Update Contact Identifiers

Tool to update a contact identifier in Piggy.

SETUP GUIDE

Connect Piggy MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
Install the Composio SDK and Claude Agent SDK
2

Create Tool Router Session

typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });

console.log("Creating Tool Router session...");
const { mcp } = await composio.create('your-user-id');
console.log(`Tool Router session created: ${mcp.url}`);
Initialize the Composio client and create a Tool Router session
3

Connect to AI Agent

typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText, stepCountIs } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: mcp.url,
    headers: { 'x-api-key': 'your-composio-api-key' }
  }
});

const tools = await client.tools();

const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{ role: 'user', content: 'Show customers who earned the most loyalty points this month' }],
  stopWhen: stepCountIs( 5 )
});

console.log(`Agent: ${text}`);
Use the MCP server with your AI agent
SETUP GUIDE

Connect Piggy API Tool with your Agent

1

Install Composio

typescript
npm install @composio/openai
Install the Composio SDK
2

Initialize Composio and Create Tool Router Session

typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
Import and initialize Composio client, then create a Tool Router session
3

Execute Piggy Tools via Tool Router with Your Agent

typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'Show customers who earned the most loyalty points this month'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
Get tools from Tool Router session and execute Piggy actions with your Agent

Why Use Composio?

AI Native Piggy Integration

  • Supports both Piggy MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your Piggy data

Managed Auth

  • Built-in API Key management without hard-coding credentials
  • Central place to manage and revoke Piggy access
  • Per user and per environment credentials for better security

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Piggy
  • Scoped, least privilege access to Piggy resources
  • Full audit trail of agent actions to support review and compliance
FAQ

Frequently asked questions

Yes, Piggy requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Start with Piggy.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Piggy tool your agent needs.Free to start.

Start building