Servers Playground How we check Add a server Log in

Postel

Working · 1.4 s

app.postel/postelv1.0.0 Domain verified

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

Marketing & SEO

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

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

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

create-post

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

contentstring, required

The post content (tweet text)

statusstring

Post status (default: DRAFT)

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Postel MCP server | mcptry

Tools (15)

create-post

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

Argument	Type	Description
status	string	Post status (default: DRAFT)
content*	string	The post content (tweet text)

Input schema (JSON)

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

delete-post

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

destructive

Argument	Type	Description
postId*	string	The post ID to delete

Input schema (JSON)

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

generate-post

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

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

Input schema (JSON)

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

get-brand-sources

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

read-only

Argument	Type	Description
brandId*	string	The brand (topic) ID to get sources for

Input schema (JSON)

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

get-post

Get a single post by ID with full details.

read-only

Argument	Type	Description
postId*	string	The post ID to retrieve

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "postId"
  ],
  "properties": {
    "postId": {
      "type": "string",
      "description": "The post ID to retrieve"
    }
  },
  "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.

read-only

No arguments.

Input schema (JSON)

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

get-usage

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

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {},
  "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.

read-only

No arguments.

Input schema (JSON)

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

list-brands

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

read-only

No arguments.

Input schema (JSON)

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

list-posts

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

read-only

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

Input schema (JSON)

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

destructive

Argument	Type	Description
postId*	string	The post ID to publish

Input schema (JSON)

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

refine-post

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

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

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "postId",
    "instructions"
  ],
  "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')"
    }
  },
  "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.

destructive

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

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "postId",
    "scheduledDateTime"
  ],
  "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)"
    }
  },
  "additionalProperties": false
}

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.

read-only

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

Input schema (JSON)

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

update-post

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

destructive

Argument	Type	Description
postId*	string	The post ID to update
status	string	New status for the post
content	string	New content for the post

Input schema (JSON)

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