API & MCP

Your AI can run your market.

Connect Claude, ChatGPT or your own agents to your larkfeed market. They read your articles, events, jobs and businesses, and file drafts for you to review. Nothing goes live until a person says yes.

mcp config
{
  "mcpServers": {
    "my-market": {
      "type": "http",
      "url": "https://your-site.com/api/mcp",
      "headers": {
        "Authorization": "Bearer lkf_..."
      }
    }
  }
}
Connect

Connected in about two minutes.

Every larkfeed site serves its own API and MCP endpoint on its own domain. A key reaches one market, and only what you allow.

  1. 01Make a key

    In your larkfeed admin, open Settings, then API keys. Name it, tick only the scopes this agent needs, and copy it. You see the full key once.

  2. 02Add it to your AI

    Point any MCP client at https://your-site.com/api/mcp with the key as a bearer token. Or call the REST API at /api/v1.

  3. 03Just ask

    "Draft a story on this weekend's three biggest events and put it in my review queue." It lands in review. You publish.

Tools

What your AI can do.

Your AI only sees the tools its key allows. Reading is one scope. Every write goes to a review queue.

Read

list_articles
Your articles, newest first, any status.
content:read
get_article
One article by id or slug, with its body.
content:read
list_events
Your events calendar.
content:read
list_jobs
Your job board.
content:read
list_businesses
Your business directory.
directory:read

Send for review

file_article_draft
A designed article draft. Always lands at review. Send the same id again to update it.
drafts:write
submit_event
An event into your events review queue.
events:write
submit_job
A job listing, held until you approve it.
jobs:write
No key can everpublish, archive, change settings, your team or your domain, or touch another market.
REST API

Same tools, plain HTTPS.

JSON in, JSON out. Lists come newest first with a cursor for the next page.

$ curl -H "Authorization: Bearer $LARKFEED_KEY" \
  "https://your-site.com/api/v1/articles?limit=5"
GET/api/v1/articlescontent:read
GET/api/v1/articles/:idOrSlugcontent:read
POST/api/v1/draftsdrafts:write
GET/api/v1/eventscontent:read
POST/api/v1/eventsevents:write
GET/api/v1/jobscontent:read
POST/api/v1/jobsjobs:write
GET/api/v1/businessesdirectory:read
1market per key. Asking for another market is refused.
0tools that can publish. A person always does.
60requests a minute per key, so a runaway agent can't flood you.
Onceis the only time you see a key. We store a hash, and you can revoke it any time.
Want your AI running your market?Book a call