# Typefully (slim)

> Typefully is a writing and scheduling app for social posts on X, LinkedIn, Threads, Bluesky, Mastodon and Substack Notes. Its REST API v2 and hosted MCP server create, schedule and publish drafts for the account's own connected profiles.

- Full: https://www.anchorterminal.com/tools/typefully.md (~7,150 tokens) · this version ~1,730 tokens · JSON https://www.anchorterminal.com/tools/typefully.json · canonical https://www.anchorterminal.com/tools/typefully
- Index: https://www.anchorterminal.com/llms.txt · API: https://www.anchorterminal.com/api/v1/index.json · Updated: 2026-10-09

**D · 49.1/100 · rank #714 of 842 · #8 in Social media posting APIs · not agent-ready · confidence medium**


Assessment: A public OpenAPI 3.1 document, Markdown docs and a hosted MCP server with OAuth cover drafts, scheduling, media and review comments, and planned drafts never publish until confirmed. Rate limits carry no published numbers, there is no status page or idempotency key, and both OAuth and API keys grant full access.

## Facts

- Kind: HTTP API · vendor: Typefully Inc. · category: Social media posting APIs · legal entity: Typefully Inc. · provenance 72/100
- Endpoint: `https://api.typefully.com` (HTTP, Streamable HTTP)
- Auth: OAuth or key · pricing: Freemium · x402: no · licence: Proprietary service under Typefully's Terms of Service. The Agent Skill and its CLI script in typefully/agent-skills are MIT
- Probe metrics: not measured yet (probes haven't run)
- Surface graded: REST API v2 at https://api.typefully.com, with the hosted MCP server at https://mcp.typefully.com/mcp as a second route to the same account
- Networks: X (posts, threads and Articles), LinkedIn, Threads, Bluesky, Mastodon and Substack Notes, through accounts the user connects in Typefully. No developer app is needed on any network
- Operations: 24 in the OpenAPI document. Drafts (list, create, get, update, delete), draft comment threads, queue and queue schedule, media upload by presigned URL, tags, social sets, LinkedIn organisation lookup
- Draft states: Draft, planned (`plan_at`, dated and never auto-published), scheduled (`publish_at` with a datetime or `next-free-slot`) and published (`publish_at: "now"`, asynchronous)
- Credentials: API keys from Settings, API, with the creating user's permissions. OAuth on the MCP server with PKCE, dynamic client registration and one scope, `full_access`
- Rate limits: Per user on every endpoint and per social set on operations such as `drafts.create`. Limits appear in `X-RateLimit-User-*` and `X-RateLimit-SocialSet-*` headers. No figures published
- Publishing quota: `publishing_quota` on a social set gives used, remaining (a number or unlimited) and the reset time of the current window
- Pagination: `limit` (default 10, maximum 50) and `offset`, with `count`, `next` and `previous` in each list response
- Errors: `error.code`, `error.message` and optional `details` with field, type and location path. 400, 401, 402, 403, 404, 409, 422 and 429 are documented per operation
- Webhooks: draft.created, draft.planned, draft.scheduled, draft.published, draft.status_changed, draft.tags_changed and draft.deleted, set up in Settings, API
- Agent Skill: typefully/agent-skills on GitHub (MIT), a Markdown skill with a Node CLI script, a test suite in CI and a dated changelog. Last commit 1 October 2026
- Sub-processors: A list dated 3 March 2026 names about 30, among them Vercel, Render, AWS, Cloudflare, Stripe, Intercom, OpenAI, Anthropic, Google, xAI and Groq

- Scores: Reliability 27, Performance pending, Schema & documentation 83, Agent ergonomics 62, Security & auth 38, Payments & pricing 30, Task success pending, Maintenance & community 82, Transparency & trust 64 · negative events -3 · total over the 7 assessed categories
- Why: Reliability, Graded as a hosted service. · Schema & documentation, Public OpenAPI 3.1.0 document for 24 operations and seven webhook events (25). · Agent ergonomics, List calls take `limit` up to 50 with a default of 10, and a draft read can drop comment markers, but there is no field selection (15). · Security & auth, OAuth on the MCP server with PKCE, dynamic client registration and revocation, and revocable API keys, but one scope `full_access` and keys… · Payments & pricing, No x402, MPP or L402 (0). · Maintenance & community, Product changelog entry on 20 September 2026 and an agent-skills commit on 1 October 2026 (30). · Transparency & trust, Closed service under published terms, with the Agent Skill under MIT (15).
- Sources: 20, open questions: 8, both in the full twin
- Capabilities: social.post, social.schedule, social.media-upload
- JSON: https://www.anchorterminal.com/api/v1/tools/typefully.json
- Verify (for the vendor): the badge `https://www.anchorterminal.com/badges/typefully.svg` or a link to https://www.anchorterminal.com/tools/typefully from a page on typefully.com or one of its subdomains, or the README of github.com/typefully/agent-skills, then `POST https://www.anchorterminal.com/api/v1/verify` `{"slug", "url"}` or `verify_listing` at /mcp; re-checked weekly, no effect on the grade. Snippets in the full twin.

## Before you call it

1. Call `GET /v2/social-sets` first. Every draft, media, tag and queue path needs a `social_set_id`
2. Use `plan_at` or omit both dates to leave a draft unpublished. `publish_at: "now"` posts at once and is asynchronous
3. Do not retry a failed publish blindly. Read the draft's `status` and `publish_state` first, because no idempotency key exists
4. Read `X-RateLimit-User-Remaining` and `X-RateLimit-SocialSet-Remaining` on each response, and wait until the `Reset` timestamp after a 429
5. Send the key only as `Authorization: Bearer`. The legacy MCP URL with `?TYPEFULLY_API_KEY=` still works and puts the key in logs

## Connect

```bash
npx skills add typefully/agent-skills
```

```bash
curl https://api.typefully.com/v2/me -H "Authorization: Bearer $TYPEFULLY_API_KEY"
```

```bash
claude mcp add typefully --transport http --url "https://mcp.typefully.com/mcp"
```
Full config and headless snippets are in the full page. Through letme (picks today, calling later): https://letme.dev/typefully

## Similar tools

| Tool | Grade | Score | Shared capabilities | Slim |
| --- | --- | --- | --- | --- |
| Zernio (formerly Late) API + MCP | B | 67.5 | social.post, social.schedule, social.media-upload | https://www.anchorterminal.com/tools/late.min.md |
| Postiz API + MCP | C | 59.3 | social.post, social.schedule, social.media-upload | https://www.anchorterminal.com/tools/postiz.min.md |
| Upload-Post API + MCP | C | 58.7 | social.post, social.schedule, social.media-upload | https://www.anchorterminal.com/tools/upload-post.min.md |
| Ayrshare API + MCP | C | 57.2 | social.post, social.schedule, social.media-upload | https://www.anchorterminal.com/tools/ayrshare.min.md |
| Mixpost API + MCP | D | 49.5 | social.post, social.schedule, social.media-upload | https://www.anchorterminal.com/tools/mixpost.min.md |


## Panel reviews (0, desk reviews from public material, no calls made)