Amcards MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Amcards MCP or direct API to send cards, automate campaigns, track mailings, and personalize outreach through natural language.

Amcards logoAmcards
Api Key

AMCards lets you create and mail personalized greeting cards online. Build stronger customer relationships with easy, automated card campaigns.

10 Tools

Try Amcards now

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

TOOL ROUTER PLAYGROUND
Amcards
Try asking
TOOLS

Supported Tools

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

Get API Schema

Tool to retrieve the entire schema for AMCards API V1.

Get Cards

Retrieve a page of cards associated with the authenticated account, using optional limit and skip pagination.

Get Category

Tool to retrieve details of a specific category by ID.

Get Category Schema

Tool to retrieve the schema for Category resource.

Get Contacts

Retrieve a list of AMCards contacts with optional limit, skip, and name or email filters.

Get Gift

Tool to retrieve details of a specific gift by ID.

Get Public Template

Tool to retrieve details of a specific public template by ID.

List Categories

Retrieve card template categories ordered by priority, with filters for parent category and title.

List Gifts

Retrieve a list of gift items offered by AMcards for selection or reference.

List Public Templates

Retrieve public card templates, optionally filtering by category or searching by name.

SETUP GUIDE

Connect Amcards MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

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

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["amcards"],
  mcp: true,
});
Create a session scoped to Amcards and read its MCP URL and headers
3

Connect your agent to the MCP server

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

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "Retrieve all contacts with last name Smith",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a Amcards request
SETUP GUIDE

Connect Amcards API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

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

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["amcards"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to Amcards
3

Run Amcards tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "Retrieve all contacts with last name Smith" }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the Amcards tool calls through the session, and print the final answer

Why Use Composio?

AI Native Amcards Integration

  • Supports both Amcards MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for sending, reading, and automating Amcards mailings

Managed Auth

  • Built-in API key management with secure vault storage
  • Central place to manage, scope, and revoke Amcards access
  • Per user and per environment credentials—no more hard-coded secrets

Agent Optimized Design

  • Tools are tuned using real error and success rates for reliable campaign automation
  • Comprehensive execution logs for every card sent or campaign triggered

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can send Amcards
  • Scoped, least privilege access to your Amcards account
  • Full audit trail of agent actions for compliance and peace of mind

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
FAQ

Frequently asked questions

Start with Amcards.It takes 30 seconds.

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

Start building