{
  "$schema": "https://static.modelcontextprotocol.io/schemas/v1/server-card.schema.json",
  "name": "st.twinpo/twinpost",
  "title": "Twinpost",
  "version": "1.0.0",
  "description": "Crosspost from chat: see the accounts and X mirrors in your Twinpost workspace, check what was mirrored or failed, preview a post on each network, draft a crosspost for Bluesky, Threads, Telegram, LinkedIn and more, and publish or retry only when you confirm.",
  "websiteUrl": "https://go.twinpo.st/mcp-server",
  "icons": [
    {
      "src": "https://twinpo.st/icon.svg",
      "mimeType": "image/svg+xml",
      "sizes": [
        "any"
      ]
    },
    {
      "src": "https://twinpo.st/icon-512.png",
      "mimeType": "image/png",
      "sizes": [
        "512x512"
      ]
    }
  ],
  "remotes": [
    {
      "type": "streamable-http",
      "url": "https://twinpo.st/mcp",
      "supportedProtocolVersions": [
        "2025-11-25",
        "2025-06-18",
        "2025-03-26"
      ]
    }
  ],
  "serverInfo": {
    "name": "twinpost",
    "title": "Twinpost",
    "version": "1.0.0",
    "description": "Crosspost from chat: see the accounts and X mirrors in your Twinpost workspace, check what was mirrored or failed, preview a post on each network, draft a crosspost for Bluesky, Threads, Telegram, LinkedIn and more, and publish or retry only when you confirm.",
    "websiteUrl": "https://go.twinpo.st/mcp-server",
    "icons": [
      {
        "src": "https://twinpo.st/icon.svg",
        "mimeType": "image/svg+xml",
        "sizes": [
          "any"
        ]
      },
      {
        "src": "https://twinpo.st/icon-512.png",
        "mimeType": "image/png",
        "sizes": [
          "512x512"
        ]
      }
    ]
  },
  "authentication": {
    "required": true,
    "schemes": [
      "oauth2"
    ]
  },
  "tools": [
    {
      "name": "whoami",
      "title": "Show Account and Workspace",
      "description": "Show the signed-in Twinpost user, the workspace this connection is bound to, and what this connection may do (read, draft, publish). Call it first. CAPABILITY: `read`: no side effects.",
      "inputSchema": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      },
      "annotations": {
        "title": "Show Account and Workspace",
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "list_accounts",
      "title": "List Connected Accounts",
      "description": "List the social accounts connected to Twinpost (X as the source, plus targets like Bluesky, Threads, Telegram, LinkedIn, Mastodon) with their id, network, handle and status. Use the ids in draft_crosspost and retry_mirror_post. CAPABILITY: `read`: no side effects.",
      "inputSchema": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      },
      "annotations": {
        "title": "List Connected Accounts",
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "list_mirrors",
      "title": "List X Mirrors",
      "description": "List the X mirrors in this workspace: which X account is the source, which accounts each new X post is copied to, whether the mirror is on or paused, and the plan cap with this month's usage. CAPABILITY: `read`: no side effects.",
      "inputSchema": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      },
      "annotations": {
        "title": "List X Mirrors",
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "list_mirror_activity",
      "title": "List Mirror Activity",
      "description": "Recent activity of one mirror, newest first: each X post, and for every target account whether it went live (with the link), is posting, was skipped (and why) or failed. A failed row with retryable: true can be sent again with retry_mirror_post. CAPABILITY: `read`: no side effects.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "mirror_id": {
            "type": "string",
            "description": "Mirror id from list_mirrors."
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 200,
            "description": "How many recent X posts to return. Default 20."
          }
        },
        "required": [
          "mirror_id"
        ],
        "additionalProperties": false
      },
      "annotations": {
        "title": "List Mirror Activity",
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "preview_crosspost",
      "title": "Preview Crosspost",
      "description": "Preview how the latest post of a connected X account looks on other networks (text trimmed to each network's limit, links and media handled per network). Nothing is posted. CAPABILITY: `read`: no side effects.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "source_account_id": {
            "type": "string",
            "description": "Id of the connected X account (list_accounts)."
          },
          "networks": {
            "type": "array",
            "minItems": 1,
            "maxItems": 10,
            "items": {
              "type": "string"
            },
            "description": "Target networks to preview, e.g. [\"bluesky\", \"threads\", \"telegram\"]."
          }
        },
        "required": [
          "source_account_id",
          "networks"
        ],
        "additionalProperties": false
      },
      "annotations": {
        "title": "Preview Crosspost",
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": true
      }
    },
    {
      "name": "draft_crosspost",
      "title": "Draft a Crosspost",
      "description": "Create a crosspost as DRAFTS, one per target account, from one text (several texts on X become a thread). Drafts never publish on their own: the user reviews them, or you call publish_draft after an explicit yes. Write like the account owner: no em or en dashes, 0 or 1 hashtag. CAPABILITY: `draft`.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "text": {
            "type": "array",
            "minItems": 1,
            "maxItems": 24,
            "items": {
              "type": "string",
              "minLength": 1
            },
            "description": "Post text. One element is a single post; more elements make a thread where the network supports it."
          },
          "account_ids": {
            "type": "array",
            "minItems": 1,
            "maxItems": 10,
            "items": {
              "type": "string"
            },
            "description": "Connected account ids to draft for (list_accounts). One draft is created per account."
          },
          "link": {
            "type": "string",
            "description": "Optional URL added at the end of the post when it is not already in the text."
          },
          "media_urls": {
            "type": "array",
            "maxItems": 4,
            "items": {
              "type": "string"
            },
            "description": "Optional public image or video URLs to attach."
          },
          "ref": {
            "type": "string",
            "maxLength": 120,
            "description": "Optional stable id for this crosspost. Sending the same ref again updates the pending drafts instead of duplicating them."
          }
        },
        "required": [
          "text",
          "account_ids"
        ],
        "additionalProperties": false
      },
      "annotations": {
        "title": "Draft a Crosspost",
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "list_drafts",
      "title": "List Drafts",
      "description": "List drafts in this workspace (id, network, text, status). PENDING drafts wait for the user; POSTED drafts carry the post id. CAPABILITY: `read`: no side effects.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "status": {
            "type": "string",
            "enum": [
              "PENDING",
              "APPROVED",
              "REJECTED",
              "POSTED"
            ],
            "description": "Only drafts at this stage. Omit for all."
          }
        },
        "additionalProperties": false
      },
      "annotations": {
        "title": "List Drafts",
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "list_scheduled_posts",
      "title": "List Scheduled Posts",
      "description": "List posts that are scheduled and not yet published, with their time and networks. CAPABILITY: `read`: no side effects.",
      "inputSchema": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      },
      "annotations": {
        "title": "List Scheduled Posts",
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "publish_draft",
      "title": "Publish or Schedule a Draft",
      "description": "Publish a draft now, or schedule it for a future time. This reaches a LIVE AUDIENCE: show the user the final text, the account and the time, get an explicit yes, then call with confirm: true. Needs a connection with publish access and a plan that includes direct posts; Twinpost's mirror plan posts through your X mirror instead and gets a clear plan message here, the draft stays ready. CAPABILITY: `publish`.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "draft_id": {
            "type": "string",
            "description": "Draft id from draft_crosspost or list_drafts."
          },
          "scheduled_for": {
            "type": "string",
            "description": "Optional future ISO 8601 time with timezone. Omit to post in about two minutes."
          },
          "confirm": {
            "type": "boolean",
            "description": "Must be true. Only send it after the user explicitly said yes to this exact action in the chat."
          }
        },
        "required": [
          "draft_id",
          "confirm"
        ],
        "additionalProperties": false
      },
      "annotations": {
        "title": "Publish or Schedule a Draft",
        "readOnlyHint": false,
        "destructiveHint": true,
        "idempotentHint": false,
        "openWorldHint": true
      }
    },
    {
      "name": "pause_mirror",
      "title": "Pause or Resume a Mirror",
      "description": "Pause or resume a mirror. Pausing stops copying new X posts right away. Resuming starts copying X posts made from now on (older posts are not sent), so it reaches a live audience: ask first and pass confirm: true. CAPABILITY: `draft`.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "mirror_id": {
            "type": "string",
            "description": "Mirror id from list_mirrors."
          },
          "paused": {
            "type": "boolean",
            "description": "true to pause, false to resume."
          },
          "confirm": {
            "type": "boolean",
            "description": "Required (true) to resume, after the user said yes. Not needed to pause."
          }
        },
        "required": [
          "mirror_id",
          "paused"
        ],
        "additionalProperties": false
      },
      "annotations": {
        "title": "Pause or Resume a Mirror",
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": true
      }
    },
    {
      "name": "retry_mirror_post",
      "title": "Retry a Failed Mirrored Post",
      "description": "Send a mirrored X post again to the target accounts where it failed (rows with retryable: true in list_mirror_activity). Only failed targets are retried; nothing new is created. This reaches a live audience: ask first and pass confirm: true. CAPABILITY: `draft`.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "mirror_id": {
            "type": "string",
            "description": "Mirror id from list_mirrors."
          },
          "event_id": {
            "type": "string",
            "description": "Event id of the X post from list_mirror_activity."
          },
          "account_ids": {
            "type": "array",
            "minItems": 1,
            "maxItems": 10,
            "items": {
              "type": "string"
            },
            "description": "Target account ids to retry."
          },
          "confirm": {
            "type": "boolean",
            "description": "Must be true. Only send it after the user explicitly said yes to this exact action in the chat."
          }
        },
        "required": [
          "mirror_id",
          "event_id",
          "account_ids",
          "confirm"
        ],
        "additionalProperties": false
      },
      "annotations": {
        "title": "Retry a Failed Mirrored Post",
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": false,
        "openWorldHint": true
      }
    }
  ],
  "resources": [],
  "prompts": []
}