# EkCoffee

> EkCoffee is a hosted, iframe-free creator support flyout and full-page payment experience. A coding agent can install it with one async script.

Contract version: 1.0.0
Website: https://ekcoffee.xyz
Widget script: https://ekcoffee.xyz/embed.v1.js
Remote MCP: https://backend.ekcoffee.xyz/mcp
Creator page pattern: https://ekcoffee.xyz/{handle}

## Agent entry points

- Full contract: https://ekcoffee.xyz/llms-full.txt
- AI agent guide: https://ekcoffee.xyz/docs/ai-agent-integration.md
- MCP reference: https://ekcoffee.xyz/docs/mcp.md
- Embed options schema: https://ekcoffee.xyz/docs/embed-options.schema.json
- Repository instruction block: https://ekcoffee.xyz/AGENTS.md

## Critical rules

- Require the creator's exact handle; never guess it.
- Prefer MCP tools get_creator, generate_embed, and validate_embed.
- Install exactly one async https://ekcoffee.xyz/embed.v1.js script.
- Use only documented data-ekcoffee-* attributes.
- Do not use an iframe or copy the hosted widget bundle.
- Do not add payment credentials, call payment endpoints directly, or change payment amounts.
- Never complete a real payment during an integration smoke test.
- Distinguish generated, locally validated, deployed, public-live, and provider-confirmed states.