Build with Ekamoira

Overview

Ekamoira provides two ways to programmatically manage your blog content:

API Keys

API keys authenticate your requests and scope them to your company account. Each key has specific permissions (scopes) that control what it can access.

Creating an API Key

1. 1

   Go to Account → API Keys in your dashboard

2. 2

   Click Create API Key

3. 3

   Give it a name (e.g., "ChatGPT Integration") and select scopes

4. 4

   Copy the key immediately - it won't be shown again!

Available Scopes

REST API

The REST API uses standard HTTP methods with JSON payloads. Authenticate by including your API key in the request headers.

Base URL

https://app.ekamoira.com/api/v1

Authentication

Include your API key in one of these headers:

# Option 1: Authorization header
Authorization: Bearer ek_live_abc123...

# Option 2: X-API-Key header
X-API-Key: ek_live_abc123...

Endpoints

{
  "title": "Getting Started with AI SEO",
  "content": "# Introduction\n\nMarkdown content here...",
  "slug": "getting-started-ai-seo",
  "excerpt": "A comprehensive guide to AI-powered SEO",
  "meta_title": "AI SEO Guide 2025 | Ekamoira",
  "meta_description": "Learn how to optimize for AI Overviews...",
  "status": "published"
}

MCP Server

The Model Context Protocol (MCP) allows AI assistants to interact with external tools. Our MCP server exposes blog management capabilities that ChatGPT, Claude, and other MCP-compatible assistants can use.

MCP Endpoint

https://app.ekamoira.com/api/mcp

Available Tools

ChatGPT Integration

Connect Ekamoira to ChatGPT using the Developer Mode MCP connector.

Setup Steps

1. 1

   Enable Developer Mode

   Go to ChatGPT Settings → General → scroll to Developer mode section and enable it.

2. 2

   Add MCP Server

   Click "Add MCP Server" and fill in the details:

   Label	ekamoira-blog
   URL	https://app.ekamoira.com/api/mcp
   Headers	Authorization: Bearer ek_live_...

3. 3

   Start Publishing

   Ask ChatGPT to "Publish a blog post about..." and it will use your connected Ekamoira account.

Example Prompts

Claude Integration

Connect to Claude Desktop or Claude Code CLI using MCP with HTTP transport.

Claude Desktop

Add to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "ekamoira-blog": {
      "transport": "http",
      "url": "https://app.ekamoira.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ek_live_your_key_here"
      }
    }
  }
}

Claude Code CLI

Add the MCP server using the CLI:

claude mcp add \
  --transport http \
  --header "Authorization: Bearer ek_live_your_key_here" \
  ekamoira-blog \
  https://app.ekamoira.com/api/mcp

Examples

cURL: Create a Blog Post

curl -X POST https://app.ekamoira.com/api/v1/blog/posts \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ek_live_abc123..." \
  -d '{
    "title": "My First API Post",
    "content": "# Hello World\n\nThis post was created via the API!",
    "status": "published"
  }'

JavaScript/TypeScript

const response = await fetch('https://app.ekamoira.com/api/v1/blog/posts', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer ek_live_abc123...',
  },
  body: JSON.stringify({
    title: 'My API Post',
    content: '# Hello World\n\nCreated via API!',
    status: 'published',
  }),
});

const post = await response.json();
console.log('Created post:', post.slug);

Python

import requests

response = requests.post(
    'https://app.ekamoira.com/api/v1/blog/posts',
    headers={
        'Authorization': 'Bearer ek_live_abc123...',
    },
    json={
        'title': 'My Python Post',
        'content': '# Hello from Python\n\nCreated via API!',
        'status': 'published',
    }
)

post = response.json()
print(f"Created post: {post['slug']}")