{
  "name": "tinypostcard",
  "version": "1.2.0",
  "description": "Send real physical postcards from an agent using templates, custom HTML, contacts, scheduling, token billing, Stripe Link agent-wallet shared payment tokens, HTTP 402 machine payments, and MCP.",
  "homepage": "https://tinypostcard.com",
  "skill_url": "https://tinypostcard.com/skill.md",
  "agents_url": "https://tinypostcard.com/agents",
  "mcp_url": "https://tinypostcard.com/api/mcp",
  "mcp_docs_url": "https://tinypostcard.com/docs/agents/mcp",
  "docs_url": "https://tinypostcard.com/docs",
  "llms_url": "https://tinypostcard.com/llms.txt",
  "agents_txt_url": "https://tinypostcard.com/agents.txt",
  "triggers": [
    "send a postcard",
    "birthday card",
    "thank you note",
    "holiday card",
    "customer follow-up",
    "handwritten note",
    "direct mail",
    "invitation",
    "congratulations",
    "condolence"
  ],
  "proactive_prompt": "Suggest postcards only for clear relationship, milestone, thank-you, birthday, invitation, or direct-mail intent.",
  "payment": {
    "stripe_checkout": true,
    "link_wallet_for_agents": true,
    "link_skill_url": "https://link.com/skill.md",
    "stripe_shared_payment_tokens": true,
    "machine_payments_402": true
  },
  "auth": {
    "type": "oauth_or_api_key",
    "preferred_connector_auth": "oauth",
    "oauth_authorization_server": "https://tinypostcard.com/.well-known/oauth-authorization-server",
    "oauth_protected_resource": "https://tinypostcard.com/.well-known/oauth-protected-resource/api/mcp",
    "headers": ["Authorization: Bearer <api_key>", "x-api-key: <api_key>"],
    "api_key_url": "https://tinypostcard.com/integrations"
  },
  "endpoints": {
    "openapi": "GET /openapi.json",
    "me": "GET /api/v1/me",
    "balance": "GET /api/v1/balance",
    "token_packs": "GET /api/v1/token-packs",
    "token_pack_checkout": "POST /api/v1/token-pack-checkout",
    "validate_address": "POST /api/v1/addresses/validate",
    "create_postcard_draft": "POST /api/v1/postcard-drafts",
    "quote_postcard_draft": "GET /api/v1/postcard-drafts/{draftId}/quote",
    "preview_postcard_draft": "POST /api/v1/postcard-drafts/{draftId}/preview",
    "send_postcard_draft": "POST /api/v1/postcard-drafts/{draftId}/send",
    "templates": "GET /api/v1/templates",
    "template_html": "GET /api/v1/templates/{templateId}/html",
    "render_postcard_preview": "POST /api/v1/postcards/preview",
    "send_postcard": "POST /api/v1/postcards/send",
    "search_contacts": "GET /api/v1/contacts/search",
    "get_contact": "GET /api/v1/contacts/{contactId}",
    "user_defaults": "GET/PATCH /api/v1/user-defaults"
  },
  "mcp": {
    "server_url": "https://tinypostcard.com/api/mcp",
    "tools": [
      "get_account",
      "list_templates",
      "validate_address",
      "search_contacts",
      "get_contact",
      "get_user_defaults",
      "update_user_defaults",
      "create_postcard_draft",
      "quote_postcard_send",
      "render_postcard_preview",
      "prepare_postcard_send",
      "send_postcard",
      "complete_checkout",
      "create_token_pack_checkout",
      "search",
      "fetch"
    ],
    "auth_modes": ["guest", "oauth", "api_key", "session"],
    "resources": ["postcard_checkout_widget", "pricing", "template_categories"],
    "prompts": ["birthday_postcard", "thank_you_postcard", "customer_follow_up_postcard"]
  },
  "metadata": {
    "tinypostcard": {
      "category": "agentic-commerce",
      "api_base": "https://tinypostcard.com/api/v1",
      "mcp_url": "https://tinypostcard.com/api/mcp",
      "skill_url": "https://tinypostcard.com/skill.md",
      "agent_setup_url": "https://tinypostcard.com/agents",
      "link_wallet_supported": true,
      "stripe_shared_payment_tokens_supported": true,
      "machine_payments_402_supported": true,
      "preferred_guest_payment_flow": "stripe_link_agent_wallet_spt"
    }
  }
}