ReelsFarm Agent Guide
Use ReelsFarm from AI agents, MCP clients, shell workflows, and TypeScript code. Start here, then fetch the exact guide your agent needs.
Choose the interface
| Use this | When | Entry point |
|---|---|---|
| MCP | Your AI client supports remote MCP servers and tool discovery. | https://mcp.reelsfarm.com/mcp |
| SDK | You are building a custom TypeScript agent or product integration. | @reelsfarm/mcp-client |
| CLI | Your agent can run terminal commands, CI jobs, or scripts. | reelsfarm |
Default endpoint
The canonical MCP endpoint is https://mcp.reelsfarm.com/mcp. The marketing page at /mcp is not the protocol endpoint.
The safety model
Every MCP connection has a server-enforced mode. Review uses prepare, review, confirm, and track. Creator can execute reversible content work immediately. Autopilot can also schedule, publish, and manage automations within plan and platform limits.
- Read-only calls inspect account state, assets, posts, events, pricing, and connected accounts.
- In Review, prepare calls return a confirmationId, operationId, summary, expiry, and credit estimate when relevant.
- In Creator or Autopilot, an allowed prepare call may execute immediately and therefore requires a stable idempotencyKey.
- reelsfarm_confirm_action is idempotent. reelsfarm_get_operation recovers the result after an ambiguous network response.
- Status calls track jobs, scheduled posts, exports, events, and webhook activity.
Fastest useful check
npm install -g @reelsfarm/mcp-client
reelsfarm login --api-key rfmcp_xxx
reelsfarm agent status
reelsfarm social connected --agentimport { ReelsFarmClient } from "@reelsfarm/mcp-client";
const rf = new ReelsFarmClient({
apiKey: process.env.REELSFARM_API_KEY,
});
const account = await rf.account.get();
const connected = await rf.social.listConnected();
console.log({ account, connected });
await rf.close();AI-readable docs
Every guide has a Markdown mirror. Agents should fetch the Markdown version when they need setup instructions, command examples, or a compact reference.
- Start here: /docs.md
- MCP: /docs/mcp.md
- MCP tool reference: /docs/mcp-tools.md
- MCP 3.0 migration: /docs/mcp-3-migration.md
- MCP 3.0 release notes: /docs/mcp-3-release-notes.md
- SDK & CLI: /docs/agents.md
- Workflows: /docs/workflows.md
- Reference: /docs/reference.md
- Webhooks: /docs/webhooks.md
- Troubleshooting: /docs/troubleshooting.md
- llms.txt: /llms.txt