Instructions for programs

How an assistant or your own program hands posts to Sentworth.

1. Pick your way in

Assistants (MCP)
Paste this address into your assistant, then sign in on our Allow page.
Your own program (API)
Make a key in Assistants and programs. Send it with each request to https://sentworth.com/v1/.

2. Connect

Address
https://sentworth.com/mcp
Copies these instructions as plain text, to paste into your assistant.

3. Hand over a post

Hand over a post: create_post, POST /v1/posts
curl https://sentworth.com/v1/posts \
  -H "Authorization: Bearer sw_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"account_ids":["id_from_list_accounts"],
       "text":"Kiln opening this Saturday, 11 to 4.",
       "time":"2026-11-23T09:20:00+04:00",
       "reference":"kiln-open-saturday"}'

The eight actions

NameWhat it doesRequest
list_accountsYour accounts and their ids.GET /v1/accounts
create_postHand over a post.POST /v1/posts
get_postOne post and its answer per account.GET /v1/posts/{id}
list_postsPosts by state or date.GET /v1/posts
create_upload_linkA link to upload a picture or video.POST /v1/uploads
cancel_postCancel a scheduled post.DELETE /v1/posts/{id}
update_postChange a scheduled post.PATCH /v1/posts/{id}
network_rulesEach network’s limits.GET /v1/networks/{network}/rules
  • list_accounts
    GET /v1/accounts
    Your accounts and their ids.
  • create_post
    POST /v1/posts
    Hand over a post.
  • get_post
    GET /v1/posts/{id}
    One post and its answer per account.
  • list_posts
    GET /v1/posts
    Posts by state or date.
  • create_upload_link
    POST /v1/uploads
    A link to upload a picture or video.
  • cancel_post
    DELETE /v1/posts/{id}
    Cancel a scheduled post.
  • update_post
    PATCH /v1/posts/{id}
    Change a scheduled post.
  • network_rules
    GET /v1/networks/{network}/rules
    Each network’s limits.

Rules

4. Hear back

Call-back address

Give us one https address in Assistants and programs. We send it a signed message when:

  • A post finishes, in any state
  • An account needs reconnecting
  • The day-50 warning before an account’s sign-in runs out

If your address does not answer, we try again for 24 hours, then email you.

Limits

  • 400 posts an hour and 100 in 5 minutes, per login.
  • 10 requests a second, per key or assistant.
  • Every answer says what is left.

Hand-overs not arriving? See Status.