Connect Claude, ChatGPT or any AI agent to your social media

See which tools your key can use, with their input schemas

curl https://api.postlore.com/v1/tools \
  -H "Authorization: Bearer $POSTLORE_API_KEY"

Check the calendar

curl -X POST https://api.postlore.com/v1/tools/check_calendar \
  -H "Authorization: Bearer $POSTLORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"days": 7}'

Response

{
  "result": {
    "workspace_id": "201385ad-d832-44ba-b43f-2e59f0ee5bdf",
    "timezone": "Africa/Accra",
    "findings": [
      "Last post went out 3 days ago.",
      "1 post scheduled in the next 7 days.",
      "Tue, Sep 29, 6:00 PM GMT: prime instagram slot with nothing scheduled.",
      "Mon, Oct 5, 6:00 PM GMT: prime instagram slot with nothing scheduled."
    ],
    "open_prime_slots": [
      { "platform": "instagram", "slot_utc": "2026-09-29T18:00:00.000Z",
        "slot_local": "Tue, Sep 29, 6:00 PM GMT", "filled": false },
      { "platform": "instagram", "slot_utc": "2026-10-05T18:00:00.000Z",
        "slot_local": "Mon, Oct 5, 6:00 PM GMT", "filled": false }
    ],
    "filled_prime_slots": [],
    "scheduled_posts": [
      { "id": "b76a9e45-…", "platforms": ["instagram"],
        "scheduled_at": "2026-09-29T14:32:21.281Z", "content": "Schedule me" }
    ],
    "last_published_at": "2026-09-26T12:32:18.990Z"
  }
}

Score a draft

curl -X POST https://api.postlore.com/v1/tools/score_draft \
  -H "Authorization: Bearer $POSTLORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content": "New kelewele spot opening Friday #kelewele", "platforms": ["instagram"], "media_types": ["image"]}'

Response

{
  "result": {
    "score": 40,
    "strengths": ["short caption", "1 top hashtag"],
    "fixes": [
      "video posts perform best for this account",
      "Schedule for Monday 18:00",
      "Add #accrafood"
    ],
    "timezone": "Africa/Accra"
  }
}

Save it as a draft

curl -X POST https://api.postlore.com/v1/tools/create_draft \
  -H "Authorization: Bearer $POSTLORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content": "Kelewele Friday is back", "platforms": ["instagram"], "idempotency_key": "kelewele-friday-1"}'

Response

{
  "result": {
    "post": {
      "id": "85f857a1-0eec-482f-a5f7-e29ff9cbb598",
      "status": "draft",
      "platforms": ["instagram"],
      "content": "Kelewele Friday is back",
      "created_by_agent": true,
      "compose_url": "https://postlore.com/dashboard/compose?draft_id=85f857a1-…",
      "…": "…"
    }
  }
}

Node 18+ — POSTLORE_API_KEY=pl_live_… node fill-gaps.mjs

// fill-gaps.mjs — draft posts for this week's open prime slots.
// Run weekly: POSTLORE_API_KEY=pl_live_… node fill-gaps.mjs
// Needs Node 18+. Use a key limited to one workspace, or pass workspace_id.

const KEY = process.env.POSTLORE_API_KEY
const API = `${process.env.POSTLORE_API_URL ?? 'https://api.postlore.com'}/v1/tools`

async function tool(name, args = {}) {
  const res = await fetch(`${API}/${name}`, {
    method: 'POST',
    headers: { Authorization: `Bearer ${KEY}`, 'Content-Type': 'application/json' },
    body: JSON.stringify(args),
  })
  const body = await res.json()
  if (!res.ok) throw new Error(`${name} failed: ${body.error.code}: ${body.error.message}`)
  return body.result
}

const calendar = await tool('check_calendar', { days: 7 })
console.log(calendar.findings.join('\n'))

for (const slot of calendar.open_prime_slots.slice(0, 3)) {
  const { ideas } = await tool('generate_ideas', { platforms: [slot.platform], count: 1 })
  const idea = ideas[0]
  const text = idea.draft ?? `${idea.hook}\n\n${idea.summary}`

  const { variants } = await tool('adapt_for_platforms', { content: text, platforms: [slot.platform] })
  const score = await tool('score_draft', {
    content: variants[0].content,
    platforms: [slot.platform],
    scheduled_at: slot.slot_utc,
  })

  // The idempotency key makes a re-run of this script safe: the same slot
  // returns the draft it already created instead of making a second one.
  const { post } = await tool('create_draft', {
    content: variants[0].content,
    platforms: [slot.platform],
    idempotency_key: `fill-gaps-${slot.platform}-${slot.slot_utc}`,
  })
  console.log(`${slot.slot_local} (${slot.platform}): score ${score.score ?? 'n/a'}, review at ${post.compose_url}`)
}

Python 3.8+ — pip install requests; POSTLORE_API_KEY=pl_live_… python fill_gaps.py

# fill_gaps.py — draft posts for this week's open prime slots.
# Run weekly: POSTLORE_API_KEY=pl_live_… python fill_gaps.py
# Needs Python 3.8+ and `pip install requests`.

import os
import requests

KEY = os.environ["POSTLORE_API_KEY"]
API = os.environ.get("POSTLORE_API_URL", "https://api.postlore.com") + "/v1/tools"


def tool(name, **args):
    res = requests.post(
        f"{API}/{name}",
        headers={"Authorization": f"Bearer {KEY}"},
        json=args,
        timeout=60,
    )
    body = res.json()
    if not res.ok:
        raise RuntimeError(f"{name} failed: {body['error']['code']}: {body['error']['message']}")
    return body["result"]


calendar = tool("check_calendar", days=7)
print("\n".join(calendar["findings"]))

for slot in calendar["open_prime_slots"][:3]:
    idea = tool("generate_ideas", platforms=[slot["platform"]], count=1)["ideas"][0]
    text = idea.get("draft") or f"{idea['hook']}\n\n{idea['summary']}"

    variant = tool("adapt_for_platforms", content=text, platforms=[slot["platform"]])["variants"][0]
    score = tool("score_draft", content=variant["content"], platforms=[slot["platform"]], scheduled_at=slot["slot_utc"])

    # Same idempotency key on a re-run returns the existing draft, not a duplicate.
    post = tool(
        "create_draft",
        content=variant["content"],
        platforms=[slot["platform"]],
        idempotency_key=f"fill-gaps-{slot['platform']}-{slot['slot_utc']}",
    )["post"]
    print(f"{slot['slot_local']} ({slot['platform']}): score {score.get('score')}, review at {post['compose_url']}")

Output

Last post went out 3 days ago.
1 post scheduled in the next 7 days.
Tue, Sep 29, 6:00 PM GMT: prime instagram slot with nothing scheduled.
Tue, Sep 29, 6:00 PM GMT (instagram): score 75, review at https://postlore.com/dashboard/compose?draft_id=…

# Connect a custom app with "Sign in with Postlore" (OAuth 2.1 + PKCE).
# Most MCP clients do all of this for you; follow it if you're building one.

# 1. Discover. /mcp answers 401 with a pointer to the metadata:
curl -si -X POST https://api.postlore.com/mcp | grep -i www-authenticate
curl -s https://api.postlore.com/.well-known/oauth-authorization-server

# 2. Register your app (skip this if your client_id is the HTTPS URL of a
#    Client ID Metadata Document — Postlore fetches it for you).
curl -s -X POST https://api.postlore.com/oauth/register \
  -H 'Content-Type: application/json' \
  -d '{"client_name": "My Agent", "redirect_uris": ["http://127.0.0.1:8765/callback"]}'
# → {"client_id": "plc_…", ...}
CLIENT_ID=plc_…

# 3. PKCE: a random verifier and its SHA-256 challenge.
VERIFIER=$(openssl rand -base64 48 | tr -d '=+/\n' | cut -c1-64)
CHALLENGE=$(printf '%s' "$VERIFIER" | openssl dgst -sha256 -binary | openssl base64 | tr '+/' '-_' | tr -d '=')

# 4. Send the user's browser here. They sign in, choose what your app may do
#    and which workspace, and come back to your redirect URI with ?code=…&state=…&iss=…
echo "https://api.postlore.com/oauth/authorize?response_type=code&client_id=$CLIENT_ID\
&redirect_uri=http%3A%2F%2F127.0.0.1%3A8765%2Fcallback&code_challenge=$CHALLENGE\
&code_challenge_method=S256&state=xyz&scope=workspace%3Aread%20insights%3Aread%20drafts%3Awrite\
&resource=https%3A%2F%2Fapi.postlore.com%2Fmcp"
CODE=…   # from the redirect; check that iss is https://api.postlore.com

# 5. Exchange the code (form-encoded). Codes work once and expire in 10 minutes.
curl -s -X POST https://api.postlore.com/oauth/token \
  -d grant_type=authorization_code -d client_id=$CLIENT_ID -d code=$CODE \
  -d code_verifier=$VERIFIER -d redirect_uri=http://127.0.0.1:8765/callback \
  -d resource=https://api.postlore.com/mcp
# → {"access_token": "pl_oat_…", "expires_in": 3600, "refresh_token": "pl_ort_…", "scope": "…"}

# 6. Use the access token like an API key, on /mcp or /v1/tools.
curl -s https://api.postlore.com/v1/tools -H "Authorization: Bearer $ACCESS_TOKEN"

# 7. Refresh before it expires. Refresh tokens rotate: store the new one.
#    Reusing an old refresh token disconnects the app.
curl -s -X POST https://api.postlore.com/oauth/token \
  -d grant_type=refresh_token -d client_id=$CLIENT_ID -d refresh_token=$REFRESH_TOKEN

# 8. Disconnect.
curl -s -X POST https://api.postlore.com/oauth/revoke -d token=$REFRESH_TOKEN

{
  "result": {
    "usage": { "action": "adapt.generate", "used": 3, "limit": 600, "remaining": 597, "warning": "none" },
    "variants": [ { "platform": "instagram", "content": "…", "characters": 118, "notes": "…" } ]
  }
}

HTTP/1.1 400 Bad Request

{
  "error": {
    "code": "workspace_required",
    "message": "This account has several workspaces. Pass workspace_id (see list_workspaces)."
  }
}