FAQ

Questions about the app and the agent layer.

This page reflects the current product: a human-friendly card app with replies, reactions, OpenAPI docs, and MCP discovery.

What is Greetu.io?

Greetu.io is a free greeting card platform for humans, plus an API and MCP server that lets AI agents create cards programmatically.

Is Greetu free to use?

Yes. Anyone can create and send greeting cards for free. Developers and agents get free API credits: 20 credits for instant anonymous signup, 50 credits with email.

How do replies and reactions work?

Recipients can reply to cards with messages and leave emoji reactions. These interactions are stored and visible to the sender. Some features use reactions to trigger unlocks or feed leaderboards.

What is MCP and why does Greetu support it?

MCP (Model Context Protocol) is an open standard that lets AI assistants like Claude, ChatGPT, Gemini, and Cursor call tools directly. Greetu exposes an MCP server so any AI agent can create greeting cards, check replies, schedule deliveries, and manage webhooks — no web scraping needed.

Can AI agents really create Greetu cards?

Yes. Agents connect via the MCP JSON-RPC endpoint at greetu.io/api/mcp and use tools like greetu.create_card, greetu.schedule_card, and greetu.list_cards. Full schemas and examples are at greetu.io/mcp.

Where is the API documentation?

The OpenAPI spec lives at /openapi.json. Interactive docs, Python/TypeScript examples, and Claude/Cursor/VS Code setup guides are at greetu.io/mcp.

Can I schedule cards to send later?

Yes. Cards can be scheduled for a future date and time. The recipient sees a countdown timer until unlock. This works via the web app or the API (greetu.schedule_card).

Does Greetu have webhooks?

Yes. You can register webhooks to receive real-time events like card.viewed, card.replied, and card.reacted. Webhooks include HMAC-SHA256 signatures and automatic retry with exponential backoff. Perfect for integrating with Make.com, n8n, Pipedream, or Zapier.

Can businesses send cards in bulk?

Yes. The bulk-schedule API accepts a CSV file and can generate personalized AI messages for up to 100 recipients in one call. Ideal for team birthdays, holiday campaigns, or customer appreciation.

How do API credits work?

Each API operation costs credits: create_card (5), schedule_card (5), reply_to_card (3), list_cards (1), get_replies (1), get_reactions (1). Anonymous signup starts with 20 credits. Email signup gives 50 credits.

Do cards have shareable links?

Every card gets a persistent, shareable URL. Send it via WhatsApp, email, SMS, or social media. No app download required for the recipient.

What platforms can connect to Greetu via MCP?

Any MCP-compatible client: Claude Desktop, Cursor, VS Code (with Cline/Roo Code), Zed, and any custom agent using the Model Context Protocol SDK.