Postel

Add to your AI

Remote MCP server (streamable HTTP). Most clients sign you in with the provider on first use.

Claude Code

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

Claude Desktop, Cursor, Windsurf (mcp config)

{
  "mcpServers": {
    "postel": {
      "url": "https://www.postel.app/api/mcp"
    }
  }
}

ChatGPT: Settings → Connectors → add a custom connector with the URL above.

How to call Postel from code (MCP)

Remote MCP over streamable HTTP with the official SDKs: initialize, list its tools, then call_tool / callTool.

Python

# pip install mcp
import asyncio
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

async def main():
    async with streamablehttp_client("https://www.postel.app/api/mcp") as (read, write, _):
        async with ClientSession(read, write) as session:
            await session.initialize()
            tools = await session.list_tools()
            print([t.name for t in tools.tools])

asyncio.run(main())

TypeScript

// npm i @modelcontextprotocol/sdk
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const client = new Client({ name: "my-agent", version: "1.0.0" });
await client.connect(new StreamableHTTPClientTransport(new URL("https://www.postel.app/api/mcp")));
console.log((await client.listTools()).tools.map((t) => t.name));

A2A vs MCP: which one to use

Call it with the Rooms SDK

Through the Rooms switchboard (a Rooms specialist answers if it doesn't). SDK docs

// npm i https://rooms.aurmada.com/sdk/rooms-a2a-0.1.0.tgz
import { Rooms } from "rooms-a2a";
const r = await new Rooms().ask("…", { agent: "postel" });

# pip install https://rooms.aurmada.com/sdk/rooms_a2a-0.1.0-py3-none-any.whl
from rooms_a2a import Rooms
r = Rooms().ask("…", agent="postel")

Track record

Uptime

Collecting: shown after 3 daily checks.

Calls via Rooms (30 days)

0

No calls through Rooms in the last 30 days yet. Rooms only counts what it brokers, hosts or checks; nothing is estimated.

Tools (15)

• Search viral X posts 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 conta…
• List posts list-posts
  List posts for the current organization. Supports filtering by status and pagination.
• Get post get-post
  Get a single post by ID with full details.
• Create draft post create-post
  Save text as a new draft in Postel. Does not publish or schedule. Each call creates a separate draft.
• Update draft post update-post
  Update the content or status of a Postel draft. Scheduled and published posts cannot be edited.
• Delete post delete-post
  Delete a post. A scheduled post's delivery is cancelled first.
• Schedule post 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.
• Publish post now 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.
• Generate post with AI generate-post
  Generate a new post using AI based on a prompt. Requires usage quota. Returns the generated post.
• Suggest post rewrite refine-post
  Suggest refined content for an existing post using AI and specific instructions. Does not save changes. Requires usage quota.
• List brands list-brands
  List all brands (topics) for the current organization. Brands contain background information used for AI post generation.
• Get brand sources get-brand-sources
  Get background information sources for a specific brand. These sources are used to inform AI post generation.
• Get voice profiles get-x-profiles
  Get the X and LinkedIn voice profiles for the current organization. These profiles define the brand voice for AI post generation.
• Get posting schedule get-schedule
  Get the posting schedule template for the current organization. Shows which time slots are configured for each day of the week.
• Get usage and limits get-usage
  Get the current usage statistics and plan limits for the organization.

Automated check: 80/100

Last run 2026-10-14 15:21 UTC. What we measured, not a guarantee.

• 10/10Every URL is https.
• 40/40MCP initialize answered (postel 1.0.0).
• 15/1515 tools listed by tools/list.
• 0/10No MCP server card at /.well-known/mcp/server-card.json.
• 10/10Has a homepage or documentation link.
• 5/5Answered in 307 ms.
• 0/10Not claimed with a domain proof yet.