Postel

Official15 tools

by robinfaraj

Draft, schedule and publish X (Twitter) and LinkedIn posts in your own voice.

app.postel/postel MCP Server

The app.postel/postel MCP server supports drafting, scheduling, and publishing posts to X (Twitter) and LinkedIn in your own voice. It provides an interface for creating content workflows that move from creation through planned publishing.

🛠️ Key Features

Draft X (Twitter) and LinkedIn posts
Schedule posts for later publication
Publish posts to X (Twitter) and LinkedIn

🚀 Use Cases

Plan and time social posts to X (Twitter) and LinkedIn
Produce draft content in your own voice and publish it later

⚡ Developer Benefits

Enables programmatic control of a posting workflow across two platforms: X (Twitter) and LinkedIn
Supports drafting, scheduling, and publishing as distinct steps

⚠️ Limitations

Limited to X (Twitter) and LinkedIn post workflows; no other platforms are described.

Topics

claude-code-pluginlinkedinmcpmcp-serversocial-mediatwitter

Captured live from the server via tools/list.

search-viral-tweets

Find high-performing public X posts in Postel's index by topic, with source links and stored engagement metrics. No login required. Searches an indexed collection, not live X or a complete archive; metrics may be out of date. Results contain third-party post text.

Parameters3

query	string	optional	Topic or keywords; omit to browse high-performing posts
minImpressions	integer	optional	Minimum stored view count (default 10000)
limit	integer	optional	Number of examples (default 10, maximum 20)

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Topic or keywords; omit to browse high-performing posts",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "minImpressions": {
      "description": "Minimum stored view count (default 10000)",
      "type": "integer",
      "minimum": 0,
      "maximum": 2147483647
    },
    "limit": {
      "description": "Number of examples (default 10, maximum 20)",
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

list-posts

List posts for the current organization. Supports filtering by status and pagination.

Parameters2

status	string	optional	Filter posts by status
limit	integer	optional	Number of posts to return (max 50, default 20)

Raw schema

{
  "type": "object",
  "properties": {
    "status": {
      "description": "Filter posts by status",
      "type": "string",
      "enum": [
        "DRAFT",
        "SCHEDULED",
        "PUBLISHED"
      ]
    },
    "limit": {
      "description": "Number of posts to return (max 50, default 20)",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

get-post

Get a single post by ID with full details.

Parameters1

postId

string

required

The post ID to retrieve

Raw schema

{
  "type": "object",
  "properties": {
    "postId": {
      "type": "string",
      "description": "The post ID to retrieve"
    }
  },
  "required": [
    "postId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

create-post

Save text as a new draft in Postel. Does not publish or schedule. Each call creates a separate draft.

Parameters2

content	string	required	The post content (tweet text)
status	string	optional	Post status (default: DRAFT)

Raw schema

{
  "type": "object",
  "properties": {
    "content": {
      "type": "string",
      "maxLength": 10000,
      "description": "The post content (tweet text)"
    },
    "status": {
      "description": "Post status (default: DRAFT)",
      "type": "string",
      "enum": [
        "DRAFT",
        "EDITING"
      ]
    }
  },
  "required": [
    "content"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

update-post

Update the content or status of a Postel draft. Scheduled and published posts cannot be edited.

Parameters3

postId	string	required	The post ID to update
content	string	optional	New content for the post
status	string	optional	New status for the post

Raw schema

{
  "type": "object",
  "properties": {
    "postId": {
      "type": "string",
      "description": "The post ID to update"
    },
    "content": {
      "description": "New content for the post",
      "type": "string",
      "maxLength": 10000
    },
    "status": {
      "description": "New status for the post",
      "type": "string",
      "enum": [
        "DRAFT",
        "EDITING"
      ]
    }
  },
  "required": [
    "postId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

delete-post

Delete a post. A scheduled post's delivery is cancelled first.

Parameters1

postId

string

required

The post ID to delete

Raw schema

{
  "type": "object",
  "properties": {
    "postId": {
      "type": "string",
      "description": "The post ID to delete"
    }
  },
  "required": [
    "postId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

schedule-post

Schedule a Postel draft for publishing to the social platform stored on the post. Requires a plan that includes scheduling. scheduledDateTime must be a future UTC ISO-8601 timestamp.

Parameters2

postId	string	required	The post ID to schedule
scheduledDateTime	string	required	UTC ISO-8601 date string for when to publish (must be in the future)

Raw schema

{
  "type": "object",
  "properties": {
    "postId": {
      "type": "string",
      "description": "The post ID to schedule"
    },
    "scheduledDateTime": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
      "description": "UTC ISO-8601 date string for when to publish (must be in the future)"
    }
  },
  "required": [
    "postId",
    "scheduledDateTime"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

publish-post

Publish a Postel draft immediately to the social platform stored on the post. Requires a plan that includes publishing. A post that is already published cannot be published again.

Parameters1

postId

string

required

The post ID to publish

Raw schema

{
  "type": "object",
  "properties": {
    "postId": {
      "type": "string",
      "description": "The post ID to publish"
    }
  },
  "required": [
    "postId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

generate-post

Generate a new post using AI based on a prompt. Requires usage quota. Returns the generated post.

Parameters4

prompt	string	required	What the post should be about
isThread	boolean	optional	Generate a thread instead of a single post (X only; ignored for LinkedIn)
platform	string	optional	Target platform: "x" (default) or "linkedin"
profileId	string	optional	Voice profile ID to use (omit to use default brand voice)

Raw schema

{
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string",
      "maxLength": 5000,
      "description": "What the post should be about"
    },
    "isThread": {
      "description": "Generate a thread instead of a single post (X only; ignored for LinkedIn)",
      "type": "boolean"
    },
    "platform": {
      "description": "Target platform: \"x\" (default) or \"linkedin\"",
      "type": "string",
      "enum": [
        "x",
        "linkedin"
      ]
    },
    "profileId": {
      "description": "Voice profile ID to use (omit to use default brand voice)",
      "type": "string"
    }
  },
  "required": [
    "prompt"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

refine-post

Suggest refined content for an existing post using AI and specific instructions. Does not save changes. Requires usage quota.

Parameters2

postId	string	required	The post ID to refine
instructions	string	required	Instructions for how to refine the post (e.g., 'make it more casual', 'add a call to action')

Raw schema

{
  "type": "object",
  "properties": {
    "postId": {
      "type": "string",
      "description": "The post ID to refine"
    },
    "instructions": {
      "type": "string",
      "maxLength": 2000,
      "description": "Instructions for how to refine the post (e.g., 'make it more casual', 'add a call to action')"
    }
  },
  "required": [
    "postId",
    "instructions"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

list-brands

List all brands (topics) for the current organization. Brands contain background information used for AI post generation.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

get-brand-sources

Get background information sources for a specific brand. These sources are used to inform AI post generation.

Parameters1

brandId

string

required

The brand (topic) ID to get sources for

Raw schema

{
  "type": "object",
  "properties": {
    "brandId": {
      "type": "string",
      "description": "The brand (topic) ID to get sources for"
    }
  },
  "required": [
    "brandId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

get-x-profiles

Get the X and LinkedIn voice profiles for the current organization. These profiles define the brand voice for AI post generation.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

get-schedule

Get the posting schedule template for the current organization. Shows which time slots are configured for each day of the week.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

get-usage

Get the current usage statistics and plan limits for the organization.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

README.md5 KBView on GitHub

Postel MCP server for X (Twitter) and LinkedIn

Draft, schedule and publish X (Twitter) and LinkedIn posts from Claude, Cursor and other MCP clients.

Postel is a writing and scheduling tool for people who post as themselves: founders, consultants and creators. Its hosted MCP server lets an AI assistant research high-performing X posts, draft posts and threads in your saved voice, and schedule or publish them to your X account and your personal LinkedIn profile once you approve.

This repository holds the public metadata for that server: the Claude plugin, the MCP Registry entry and setup instructions. The server itself is hosted by Postel; there is nothing to run locally.


Server URL	`https://www.postel.app/api/mcp`
Transport	Streamable HTTP
Authentication	OAuth 2.1 with dynamic client registration, or an API key as a bearer token
Registry name	`app.postel/postel`

Setup

Post research (search-viral-tweets) works without an account. For everything else you need a Postel account; connect your X account, your LinkedIn profile or both under Settings > Channels.

Claude Code plugin

code

/plugin marketplace add robinfaraj/postel-mcp
/plugin install postel@postel

Then run /mcp and sign in to Postel. The plugin adds the server and a postel-writing skill that teaches Claude the drafting and scheduling workflow.

Claude Code without the plugin

bash

claude mcp add --transport http postel https://www.postel.app/api/mcp

Run /mcp to sign in. To use an API key instead:

bash

claude mcp add --transport http postel https://www.postel.app/api/mcp --header "Authorization: Bearer pstl_YOUR_API_KEY"

Claude (web and desktop)

Open Customize > Connectors, click +, choose Add custom connector, enter https://www.postel.app/api/mcp and sign in to Postel when asked.

Cursor

Add this to your MCP settings (~/.cursor/mcp.json or .cursor/mcp.json in a project):

json

{
  "mcpServers": {
    "postel": {
      "url": "https://www.postel.app/api/mcp",
      "headers": {
        "Authorization": "Bearer pstl_YOUR_API_KEY"
      }
    }
  }
}

Create the key in Postel under Settings > API Keys. Keys start with pstl_ and are scoped to one workspace.

Other clients

Any client that supports remote MCP servers over Streamable HTTP works. Point it at the server URL above and either let it run the OAuth sign-in or send Authorization: Bearer pstl_YOUR_API_KEY.

Tools

Posts

Tool	What it does
`list-posts`	Lists posts, with an optional status filter
`get-post`	Returns one post by ID
`create-post`	Saves text as a new draft
`update-post`	Edits a draft
`delete-post`	Deletes a post and cancels its schedule
`schedule-post`	Schedules a draft for a future time
`publish-post`	Publishes a draft now

Writing and research

Tool	What it does
`generate-post`	Writes an X post, an X thread or a LinkedIn post in your voice and saves it as a draft
`refine-post`	Suggests a rewrite of a draft from your instructions
`search-viral-tweets`	Finds high-performing X posts by topic in Postel's library. No sign-in needed

Context

Tool	What it does
`list-brands`	Lists your brands and topics
`get-brand-sources`	Returns background sources for a brand
`get-x-profiles`	Returns your voice profiles
`get-schedule`	Returns your weekly posting slots and timezone
`get-usage`	Shows usage and plan limits

Example prompts

"Find viral posts about bootstrapping a SaaS and tell me what the best hooks have in common."
"Draft a LinkedIn post about the pricing change we shipped this week."
"Write a thread about what we learned from our last launch."
"Show me what is scheduled for next week."
"Schedule that post for Tuesday at 9am Berlin time."

What it does not do

It does not read your X timeline, mentions or DMs, or your LinkedIn feed or messages.
It does not like, reply, follow, comment or send connection requests.
LinkedIn posts go to personal profiles only, not company pages.
Images, video, documents and LinkedIn first comments are added in the Postel editor, not through MCP.
Research searches Postel's indexed library of X posts, not live X.

Plans and limits

Research needs no account. Drafting and reading posts work on any plan, and AI generation counts against your monthly quota.
Scheduling and publishing need a paid plan or trial. See pricing.
API keys are limited to 60 requests per minute.

License

The files in this repository are released under the MIT License. The Postel service is covered by its own terms.

Install

Tools (15)

search-viral-tweetslist-postsget-postcreate-postupdate-postdelete-postschedule-postpublish-post

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://www.postel.app/api/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "postel": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://www.postel.app/api/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

app.postel/postel MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

search-viral-tweets

list-posts

get-post

create-post

update-post

delete-post

schedule-post

publish-post

generate-post

refine-post

list-brands

get-brand-sources

get-x-profiles

get-schedule

get-usage

Postel MCP server for X (Twitter) and LinkedIn

Setup

Claude Code plugin

Claude Code without the plugin

Claude (web and desktop)

Cursor

Other clients

Tools

Posts

Writing and research

Context

Example prompts

What it does not do

Plans and limits

Links

License

Install

Remote endpoint

Related servers