Developer REST API & MCP Server Quickstart

## Developer API & MCP Quickstart ESER AI provides two developer interfaces: 1. **REST API (`https://app.eserai.tech/v1`):** High-performance HTTP REST API for backend services, webhooks, and automation tools (n8n, Make, Zapier). 2. **Model Context Protocol (`https://app.eserai.tech/mcp`):** Standardized protocol allowing LLM agents (Claude Desktop, Cursor, Claude Code, Antigravity) to directly inspect accounts, draft posts, and schedule content. --- ### Authentication All API and MCP requests require an authenticated Bearer API key. #### Generating an API Key: 1. Open **Dashboard -> Settings -> Developer / API Keys** (`https://app.eserai.tech/dashboard/settings/developer`). 2. Click **Create API Key**, provide a descriptive label (e.g., `Production-n8n-Runner`), and select your desired permission scopes. 3. Copy the generated key (`eser_api_...`). Store it securely; keys are hashed at rest and cannot be viewed again. #### Making Your First REST API Call: ```bash curl -X GET "https://app.eserai.tech/v1/accounts" \ -H "Authorization: Bearer YOUR_ESER_AI_API_KEY" \ -H "Content-Type: application/json" ``` --- ### Core REST API Endpoints - `GET /v1/accounts`: List all connected social channels, account IDs, and health statuses. - `POST /v1/posts`: Create, draft, or immediately publish a post across one or more target channels. - `GET /v1/posts/:id`: Fetch execution status, provider post URLs, and error diagnostics. - `POST /v1/sources/ingest`: Ingest an article URL or text chunk for automated content extraction. - `GET /v1/queue/slots`: Retrieve scheduled calendar queue timeslots. - `POST /v1/media`: Upload media assets to secure storage and retrieve storage keys. --- ### Model Context Protocol (MCP) Configuration Add ESER AI to your `claude_desktop_config.json` or Cursor `mcp.json`: ```json { "mcpServers": { "eser-ai": { "command": "npx", "args": ["-y", "@eser-ai/mcp-server"], "env": { "ESER_AI_API_KEY": "YOUR_ESER_AI_API_KEY" } } } } ``` Once connected, your AI assistant can execute commands such as: - *"List my connected social channels."* - *"Draft a LinkedIn thought leadership post from this URL and schedule it for tomorrow morning."* - *"Check the publishing status of my latest video post."*