Publinio Social Media MCP

Connect your AI assistant to your Publinio social workspace: brand context, reviewable drafts, future scheduling, saved analytics, and permissioned research.

Connect your assistant · Tool reference · Examples · Publinio · Developer docs

Official MCP Registry entry: com.publinio/social-media-mcp.

Connect

Hosted MCP endpoint

https://api.publinio.com/mcp

Choose Streamable HTTP and OAuth in your MCP client. Sign in to Publinio, select the intended brands, and authorize the permissions you need. A Publinio account is required; client/workspace access, plan allowances, and workspace credits apply.

Start with a read-only prompt:

Use Publinio to list the brands I can access, then show the context for the brand I choose. Do not change anything.

Step-by-step setup for ChatGPT, Claude and Claude Code →

Related MCP server: @orchyn/mcp

What you can do

Draft creation saves a draft. Scheduling is a separate action with revision, approval, destination and credit checks. X scheduling reserves the required workspace credits. Saved analytics do not silently trigger paid refreshes. Permissions and costs →

Run the examples

Node.js 22 or newer:

git clone https://github.com/Kingjam99/social-media-mcp.git
cd social-media-mcp
npm ci
npm run example -- discover

The example prints a Publinio sign-in URL. Open it in your browser and authorize the requested brand access. Tokens stay in memory and expire with the process.

Create a draft, schedule a reviewed post, or read saved analytics →

What's in this repository

• Current client setup and practical prompt workflows.

• A versioned public catalogue: 80 tool descriptors, including 76 model-callable tools and 4 app-only controls. Each includes input/output schemas and required scope.

• Runnable JavaScript examples built on the official MCP SDK.

• Original Publinio cover artwork and a 1280 × 640 social-preview image.

• Contribution, security and MIT license guidance.

This repository is the public integration kit for Publinio's hosted service. Running the examples connects to Publinio; it does not start a local Publinio server. The hosted application, infrastructure and provider credentials are managed separately.

Compatibility and verification

The server uses Streamable HTTP, OAuth, and optional MCP Apps UI. Clients that support the transport and authorization can use permitted model-callable tools; embedded cards depend on the client's MCP Apps support.

Local protocol integration tests cover discovery, draft/scheduling behavior and saved metrics. OAuth callback and permission guards are tested. These checks do not certify every assistant's current UI or a real-account publishing journey. The catalogue is a 2026-10-07 snapshot; live tool discovery and get_workspace_capabilities determine current access.

Hosting and catalogue versions · Troubleshooting · Contributing · Security

License

Code and documentation are MIT licensed. Publinio's name and brand marks remain subject to their owners' trademark rights. The hosted service uses its own terms and privacy policy.