freepost
Provides Xiaohongshu-specific platform rules through Freepost, allowing agents to retrieve posting and content requirements for preparing social posts for Xiaohongshu.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Freepost for agents
Use Freepost from Claude Code, Codex, Cursor, or your terminal. The package talks to your Freepost workspace and can work with social accounts you already connected in Freepost → Accounts.
Install
After the npm release, use Node.js 20 or newer and run:
npx freepost setupCreate a workspace API key in Freepost → Settings → API keys and enter it at the hidden prompt. Setup checks the key against Freepost, stores it in ~/.config/freepost/credentials with mode 0600 on Unix, registers MCP, and installs the bundled skill. Restart the agent after setup. Re-running setup preserves other server entries and skips its existing configuration and identical skill files. On a clean machine with no detected clients, setup configures all three.
npx freepost setup --dry-run
npx freepost setup --only claude,codex,cursor --yes
npx freepost login
npx freepost doctorFor non-interactive setup, supply FREEPOST_API_KEY through your environment or secrets manager, use a stored key, or pass --key. Prefer the environment over --key when shell history or process arguments are visible. The key stays out of the MCP configurations. The CLI and stdio server prefer FREEPOST_API_KEY over the stored key. Set FREEPOST_API_URL (or FREEPOST_BASE_URL) to an HTTPS service base URL or an HTTP loopback base URL for local testing. The default is https://freepost.io.
Doctor checks authenticated MCP initialization and reports both CLI and server versions. It reports null for the key's scopes and plan, which the current server does not disclose on initialization. Review them in Freepost Settings.
Claude Code
npx freepost setup --only claudeSetup runs claude mcp add freepost -s user -- npx -y freepost mcp when the Claude CLI is on PATH. The fallback writes the user MCP entry in ~/.claude.json. The skill installs to ~/.claude/skills/freepost. With CLAUDE_CONFIG_DIR set, setup uses that directory for the user config and skill.
Codex
npx freepost setup --only codexSetup uses ~/.codex/config.toml (or $CODEX_HOME/config.toml) and installs the skill to ~/.agents/skills/freepost. To configure MCP manually after npx freepost login, add:
[mcp_servers.freepost]
command = "npx"
args = ["-y", "freepost", "mcp"]
env_vars = ["FREEPOST_API_KEY", "FREEPOST_API_URL", "FREEPOST_BASE_URL"]Cursor
npx freepost setup --only cursorSetup registers the server in ~/.cursor/mcp.json and installs the skill to ~/.cursor/skills/freepost. To configure MCP manually after npx freepost login, merge this entry into your existing config:
{
"mcpServers": {
"freepost": {
"command": "npx",
"args": ["-y", "freepost", "mcp"]
}
}
}Skill-only installation
Once the standalone source repository is public, install the Freepost skill through the skills CLI:
npx skills add Youhai020616/freepost-agentThe skill works with the local stdio server or a direct connection to Freepost remote MCP using Streamable HTTP and OAuth. See the bundled Claude Code, Codex, and MCP-only examples.
Related MCP server: Postoir
Use the CLI
npx freepost --help
npx freepost accounts
npx freepost rules xiaohongshu
npx freepost posts --status draft --limit 10
npx freepost upload ./cover.png
npx freepost validate @draft.json
npx freepost draft @draft-with-idempotency-key.json
npx freepost post <post-id>draft, validate, and update accept an inline JSON object, @FILE, or - for stdin. See the Freepost API contract for input fields. For example, a draft's JSON can include content, targetAccounts (Freepost account IDs), optional title and mediaIds, and an idempotencyKey you retain for retries.
Ask the user to approve the exact content, destination, and time before publishing or scheduling. The bundled stdio tools require confirmed: true, and the CLI requires --confirmed. Freepost enforces publish:write for publishing and schedules:write for scheduling. Select those scopes when creating a key that needs them.
npx freepost publish <post-id> --idempotency-key <publish-key> --confirmed
npx freepost schedule <post-id> 2099-07-02T09:00:00+08:00 --idempotency-key <schedule-key> --confirmed
npx freepost publication <delivery-id>Reuse the same idempotency key for the same request after a lost response. Check a pending or unknown delivery with publication before taking further action.
MCP tools
freepost mcp discovers the service's tool and resource schemas over Streamable HTTP. These are the tools implemented by the Freepost remote MCP API at this release:
Tools | CLI |
|
|
|
|
|
|
|
|
|
|
The CLI's posts and media list commands use the corresponding REST endpoints. The upload tool takes a URL or base64 bytes, and the CLI can encode a local file for it. Analytics is outside the current remote MCP tool surface. Draft text comes from the user's agent.
Build and test
From a Freepost monorepo checkout:
pnpm install --frozen-lockfile
pnpm --filter ./packages/freepost-agent build
pnpm --filter ./packages/freepost-agent test
pnpm platform-rules:check
node packages/freepost-agent/dist/cli.js --helpFrom a standalone source checkout, use npm install, npm test, and npm run build. The monorepo generates the bundled platform files from the platform skills and shared content rules. Change those upstream sources and regenerate before exporting a new version.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Draft, validate, publish, schedule, and manage social posts across connected accounts.
Draft, schedule and publish social posts to your connected accounts, and read their results.
Publish and schedule social posts, upload media, and review analytics through OAuth.
Publish and schedule social media posts and read analytics across 12 networks through one API.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables agents to manage social media publishing, media uploads, and content queues through the Postifys API.1715 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables MCP-compatible assistants to manage social publishing workflows, including creating drafts, uploading media, scheduling, publishing, and monitoring delivery.6 npmApache 2.0
- AlicenseAqualityCmaintenanceEnables MCP clients to publish, edit, delete, comment on, and reshare posts; upload images, videos, and documents; and access optional reaction, engagement, and company-Page tools when authorized.10MIT
- AlicenseAqualityCmaintenanceEnables AI assistants and autonomous agents to connect to social media accounts and manage, generate, schedule, upload media for, and publish content across Facebook Pages, YouTube, TikTok, Instagram, and X, plus maintain a content pipeline.14MIT