# Amcards — how to use (mcp.ai)

Connect your Amcards account and use 10 tools for marketing automation straight from your AI agent. Connect with your own API key. AMCards enables users to create personalized greeting cards, automate mailing campaigns, strengthen customer relationships using a convenient online platform for individualized connections.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_amcards?ms=1787291280000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `amcards_get_api_schema`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/amcards`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/amcards/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/amcards/get/api/schema` — Tool to retrieve the entire schema for AMCards API V1. Use when you need to discover available API endpoints, resources, and their structure.
- `POST https://api.mcp.ai/api/amcards/get/cards` — This tool retrieves a list of all cards associated with the authenticated account. The action is completely independent and doesn't require any external resource IDs or parameters beyond authenticatio
  - body: { skip?: integer, limit?: integer }
- `POST https://api.mcp.ai/api/amcards/get/category` — Tool to retrieve details of a specific category by ID. Use when you need to fetch information about a card template category including its title, hierarchy, and priority.
  - body: { category_id: integer }
- `POST https://api.mcp.ai/api/amcards/get/category/schema` — Tool to retrieve the schema for Category resource. Categories are readonly. Use when you need to understand the structure and available fields of the Category resource.
- `POST https://api.mcp.ai/api/amcards/get/contacts` — This tool retrieves a list of contacts from AMCards. It is used for managing contacts by providing details like limit, skip, and filters (e.g., last_name, first_name, email). The tool returns an array
  - body: { skip?: integer, email?: string, limit?: integer, last_name?: string, first_name?: string }
- `POST https://api.mcp.ai/api/amcards/get/gift` — Tool to retrieve details of a specific gift by ID. Use when you need to fetch information about a particular gift including its name, description, price, shipping cost, and availability.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/amcards/get/public/template` — Tool to retrieve details of a specific public template by ID. Use when you need to get information about a specific template including its configuration, panels, and metadata.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/amcards/list/categories` — Tool to retrieve a list of card template categories from AMCards. Categories are returned ordered by their priority (1 is highest). Use when you need to browse available categories, filter by parent c
  - body: { parent__id?: integer, title__icontains?: string, parent__title__icontains?: string }
- `POST https://api.mcp.ai/api/amcards/list/gifts` — Tool to retrieve a list of Gift items offered by AMcards. Use when you need to display or reference available gifts for selection or purchase. No authorization required.
- `POST https://api.mcp.ai/api/amcards/list/public/templates` — Tool to retrieve a list of public templates available to all users. Use when you need to browse or search available card templates. No authorization required for this endpoint.
  - body: { category__id?: integer, name__icontains?: string }

## Example prompts
- "What can I do in Amcards?"
- "Show me a summary of my Amcards account"

## More
- Page: https://mcp.ai/amcards
- Agent spec (llms.txt): https://mcp.ai/amcards/llms.txt
- Postman collection: https://mcp.ai/amcards/postman.json