Skip to main content

​
Overview

The Writesonic Agents MCP server lets an AI assistant work with your Agents workspace directly from a conversation. Ask it to list your tasks, create one, inspect a playbook or grid, search your knowledge sources, or pull a content-intelligence report, and it calls the right tool for you. Server URL:
Agents is in beta. Access is currently limited to selected enterprise and agency accounts. To request it, talk to your account manager or book a demo with our sales team.
This is a different server from the GEO MCP at mcp.writesonic.com. The GEO server answers questions about your AI-search visibility data; the Agents server operates your Agents workspace: projects, tasks, playbooks, grids, and knowledge.

​
What You Can Do

  • Manage tasks: create tasks, query and filter them, transition status, assign owners, and comment
  • Track agent work: pull agent-run history and step-by-step progress for a task or agent
  • Inspect playbooks: browse a project’s playbooks, versions, runs, and the building-block components
  • Read grids: list grids and read their columns, rows, cells, and cell run detail
  • Search knowledge: run semantic search across your project’s knowledge sources, and read the Brand Kit
  • Pull content intelligence: get the page dashboard and per-page SEO, citation, funnel, traffic, and SERP reports
  • See your setup: resolve your identity and projects, list integrations, users, labels, skills, and agents
  • Handle attachments: get short-lived download URLs for task and comment attachments

​
Connection Methods

Team and Enterprise admins can roll the connector out org-wide, see Organization Setup.

​
How It Works

  1. Connect: add the Agents MCP server URL to your assistant
  2. Authenticate: sign in with your Writesonic account via OAuth when prompted
  3. Work: ask in natural language; the assistant calls the tools

​
Example Conversation

You: What tasks are open in my project, and who’s on them? Assistant: Let me check your Agents workspace. Assistant calls whoami, then query_tasks with view: "list" scoped to your project.

​
Scoping: projects come first

Almost every tool needs a project_id. Start each session by having the assistant call whoami, it returns your identity, your teams, and the projects in your active workspace. The assistant uses a project’s id from that response for every following call. If more than one project could match, the assistant should ask rather than guess.

​
Requirements

  • A Writesonic account with Agents access (beta)
  • At least one project in your Agents workspace

​
Available Tools

The server exposes 20 tools for reading and operating your Agents workspace, plus two meta-tools (execute_batch, execute_plan) for chaining calls efficiently. See the Tools Reference for full details. The core tools to know:

​
Next Steps

Setup Guide

Platform-specific setup instructions

Tools Reference

Every tool, its purpose, and its REST equivalent

Use Cases & Examples

Real-world prompts and use cases

Agents REST API

Call the same tools over HTTP