# ESER AI — Social Media API and MCP for AI Agents (llms.txt)

> ESER AI is an autonomous, multi-channel social media publishing engine, video synthesis studio, and Model Context Protocol (MCP) server designed for AI agents, developers, and creators.

## Canonical Domains & Endpoints
- Main Website: https://www.eserai.tech
- Dashboard Application: https://app.eserai.tech
- Help Center: https://help.eserai.tech
- REST API (v1 / v2): https://app.eserai.tech/v1
- Hosted MCP Server: https://app.eserai.tech/mcp

## Core Capabilities & Current Product Truth (September 2026)
- REST base URL: `https://app.eserai.tech/v1`, authenticated with `eser-api-key: YOUR_API_KEY` or `Authorization: Bearer YOUR_API_KEY`.
- 38 named MCP tools across 11 functional categories.
- 9 Publishing platforms: Instagram, TikTok, LinkedIn, Facebook, X (Twitter), Threads, Bluesky, Pinterest, YouTube.
- Analytics: 8 platforms (X, Instagram, Facebook, Threads, Bluesky, TikTok, YouTube, Pinterest; LinkedIn excluded).
- Comments & Conversations: Instagram and Facebook supported for comment read/reply and direct messages.
- DM Automations: Keyword-triggered auto-replies and lead magnet fulfillment on Instagram and Facebook respecting Meta 24-hour response windows and 7-day comment reply policies.
- Content Sources: Ingest URLs, YouTube video transcripts, PDF documents, and text sources.
- Visuals & Templates: Programmatic vertical video rendering, image slideshows, quote cards, and slide deck generation.
- Timezone Model: Web calendar interface displays times in the user's local timezone. API and automated scheduled timestamps require ISO-8601 strings with explicit timezone offsets (e.g. `2026-09-18T15:00:00-04:00`); offset-less values default to UTC.
- Pricing: Flat predictable tiers without per-post fees. Starter $29/mo (20 accounts, 1,250 credits), Creator $97/mo (40 accounts, 5,000 credits), Agency $499/mo (100 accounts, 28,000 credits). 7-day trial with 60 credits requires a valid payment method.

## Documented AI Agent Clients (15)
- [Claude.ai](https://www.eserai.tech/ai-agent/claude): OAuth or custom connector.
- [Claude Cowork](https://www.eserai.tech/ai-agent/cowork): OAuth custom connector, no terminal required.
- [Claude Code](https://www.eserai.tech/ai-agent/claude-code): `claude mcp add --transport http ESER https://app.eserai.tech/mcp`.
- [ChatGPT](https://www.eserai.tech/ai-agent/chatgpt): OpenAPI schema integration via Developer mode.
- [OpenAI Codex](https://www.eserai.tech/ai-agent/codex): `eser-api-key` header over streamable HTTP.
- [Google Antigravity](https://www.eserai.tech/ai-agent/antigravity): `serverUrl` in `~/.gemini/config/mcp_config.json`.
- [Cursor](https://www.eserai.tech/ai-agent/cursor): `eser-api-key` header, `url` in `~/.cursor/mcp.json`.
- [Replit Agent](https://www.eserai.tech/ai-agent/replit): Added by URL in Integrations tab.
- [Windsurf](https://www.eserai.tech/ai-agent/windsurf): `serverUrl` in `~/.codeium/windsurf/mcp_config.json`.
- [Perplexity Computer](https://www.eserai.tech/ai-agent/perplexity): OAuth or API key connector.
- [OpenClaw](https://www.eserai.tech/ai-agent/openclaw): `openclaw mcp add eser --url https://app.eserai.tech/mcp --transport streamable-http`.
- [Hermes Agent](https://www.eserai.tech/ai-agent/hermes): YAML under `mcp_servers` in `~/.hermes/config.yaml`.
- [OpenCode](https://www.eserai.tech/ai-agent/opencode): `type: "remote"` in `opencode.json`.
- [Gemini CLI](https://www.eserai.tech/ai-agent/gemini): `httpUrl` in Gemini CLI configuration.
- [NanoClaw](https://www.eserai.tech/ai-agent/nanoclaw): stdio-to-HTTP bridge via `mcp-remote`.

## 38 Named MCP Tools
- Accounts (3): `eser_get_user`, `eser_list_accounts`, `eser_list_pinterest_boards`
- Credits (2): `eser_get_credits`, `eser_buy_credits`
- Publishing (3): `eser_create_post`, `eser_get_post_status`, `eser_list_posts`
- Analytics (2): `eser_list_top_posts`, `eser_get_post_analytics`
- Comments (3): `eser_list_comments`, `eser_get_comment`, `eser_post_comment`
- Messages & DMs (5): `eser_list_conversations`, `eser_get_conversation`, `eser_list_messages`, `eser_get_message`, `eser_send_message`
- DM Automations (7): `eser_create_automation`, `eser_list_automations`, `eser_update_automation`, `eser_delete_automation`, `eser_list_automation_runs`, `eser_list_automation_logs`, `eser_get_automation_analytics`
- Content Extraction (3): `eser_create_source`, `eser_extract_content`, `eser_get_source_status`
- Visuals & Media (5): `eser_list_visual_templates`, `eser_list_templates`, `eser_create_visual`, `eser_get_visual_status`, `eser_create_presigned_upload_url`
- Content Schedules (4): `eser_list_schedules`, `eser_get_schedule`, `eser_update_schedule`, `eser_delete_schedule`
- Media Extension (1): `eser_upload_media`

## Free Online Creator Tools (14)
- [AI Watermark Remover](https://www.eserai.tech/tools/ai-watermark-remover)
- [Hashtag Generator](https://www.eserai.tech/tools/hashtag-generator)
- [Instagram Caption Generator](https://www.eserai.tech/tools/instagram-caption-generator)
- [Instagram Font Generator](https://www.eserai.tech/tools/instagram-font-generator)
- [Instagram Bio Generator](https://www.eserai.tech/tools/instagram-bio-generator)
- [Instagram Username Checker](https://www.eserai.tech/tools/instagram-username-checker)
- [Aesthetic Username Generator](https://www.eserai.tech/tools/aesthetic-username-generator)
- [TikTok Username Ideas](https://www.eserai.tech/tools/tiktok-username-ideas)
- [Best Time to Post Calculator](https://www.eserai.tech/tools/best-time-to-post)
- [Social Post Preview Tool](https://www.eserai.tech/tools/post-preview)
- [Social Media Scorecard](https://www.eserai.tech/tools/social-media-scorecard)
- [Agent Capability Explorer](https://www.eserai.tech/tools/agent-capability-explorer)
- [Social Media API Cost Calculator](https://www.eserai.tech/tools/social-media-api-cost-calculator)
- [Claude Skills Pack](https://www.eserai.tech/tools/claude-skills)

## Key Documentation Paths
- [Welcome & Onboarding](https://help.eserai.tech/start)
- [API Quickstart](https://help.eserai.tech/api/start)
- [API Reference for LLMs](https://help.eserai.tech/api/llm)
- [MCP Server Setup](https://help.eserai.tech/api/mcp)
- [Visual Templates Reference](https://help.eserai.tech/api/visuals)
- [DM Automations Guide](https://help.eserai.tech/support/dm-automations)
- [n8n Node Integration](https://help.eserai.tech/api/n8n/eser-ai-node)
- [Make.com Integration](https://help.eserai.tech/api/make.com)