Docs

Hosted MCP tell your AI to connect to Unspar

The hosted MCP server lives at https://app.unspar.com/mcp. Hosts discover the OAuth endpoints on their own, you approve the connection in your browser, and the agent receives its own credentials. Nothing to install, nothing to paste.

Claude Code

claude mcp add --transport http unspar https://app.unspar.com/mcp

Then run /mcp inside Claude Code and choose Authenticate for Unspar. The browser page described under What you approve opens, and the tools appear in the session once you confirm.

Codex CLI

codex mcp add unspar --url https://app.unspar.com/mcp

Codex handles the OAuth flow the same way: it opens the consent page in your browser and keeps the credentials it receives.

Cursor, Windsurf, Claude Desktop and other hosts

Add a remote MCP server with the URL https://app.unspar.com/mcp and the transport Streamable HTTP. If the host asks for a configuration snippet:

{
  "mcpServers": {
    "unspar": { "url": "https://app.unspar.com/mcp" }
  }
}

Any host that supports remote MCP servers with OAuth works the same way. If a host only supports local servers over stdio, use the CLI as a local MCP server instead.

Tools

The hosted server exposes these tools. Which ones a connection actually sees depends on the permission groups and projects you approved.

Tool	Group	Purpose
`unspar_whoami`	Baseline	Show the connected team, the permissions granted and the projects in reach.
`unspar_project_list`	Read	List the projects the connection may reach.
`unspar_project_show`	Read	Show one project with its default template, voice and outlet.
`unspar_article_list`	Read	List articles in a project with their status.
`unspar_article_show`	Read	Show one article, including its research sources.
`unspar_article_status`	Read	Read generation and publishing status for an article.
`unspar_article_content`	Read	Fetch the finished markdown.
`unspar_outlet_list`	Read	List publishing destinations.
`unspar_template_list`	Read	List templates.
`unspar_voice_list`	Read	List voice profiles.
`unspar_credits_balance`	Read	Show the remaining credit balance.
`unspar_credits_transactions`	Read	List recent credit transactions.
`unspar_article_create`	Generate	Create an article from a brief and start generation. Spends credits.
`unspar_article_cancel`	Generate	Stop a run that is still generating.
`unspar_article_retry`	Generate	Restart a failed run. Spends credits.
`unspar_article_publish`	Publish	Schedule publication to a connected outlet.

A typical session: the agent calls unspar_project_list, creates an article with unspar_article_create, polls unspar_article_status, reads the draft with unspar_article_content, and, if you granted publishing and ask for it, schedules it with unspar_article_publish.

Review and revoke

Connections are listed under Team settings, MCP connections, with the host, the permission groups, the projects and when the connection was last used. Revoke one there and its credentials stop working immediately. Reconnecting from the host starts a fresh consent page.

Local MCP through the CLI

If you would rather keep everything on your machine, the unspar CLI serves the same tools locally over stdio and reuses your CLI login:

claude mcp add unspar -- unspar mcp serve

The local server exposes 19 tools: the hosted set plus unspar_auth_env, unspar_article_approve and unspar_project_create. Permissions come from the login or the UNSPAR_API_KEY the process inherits.

Agent skill file

Alongside the MCP connection, a skill file teaches the agent the Unspar workflow: which tool or command to run, how to wait for generation and when to publish.

mkdir -p .claude/skills/unspar && curl -fsSL https://app.unspar.com/skills/unspar/SKILL.md -o .claude/skills/unspar/SKILL.md

Codex reads the same file from .agents/skills/unspar/SKILL.md.

Previous ← The unspar CLI Next REST API →