> For the complete documentation index, see [llms.txt](https://docs.frase.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.frase.io/automations/automate-with-frase-mcp.md).

# Automate with Frase MCP

What becomes possible when Claude and other LLMs can operate Frase on your behalf.

{% hint style="info" %}
**Ready to jump right in?** Download Frase MCP in the Claude Directory [here](https://claude.ai/customize/connectors/directory/frase). For ChatGPT, click **Connect in ChatGPT** under **Settings → API Keys** in Frase to add the [official Frase app](https://chatgpt.com/plugins/plugin_asdk_app_6a8768ef78508191958cc33d37b7f6c8). For Cursor, use the [npm package](https://www.npmjs.com/package/@frase/mcp-server) and add **next.frase.io/api/mcp** as a connector.
{% endhint %}

### What Frase MCP Can Do

Frase's MCP integration lets Claude, ChatGPT, or Cursor run research, create briefs, audit your site, find content gaps, optimize articles, and more — driven entirely by a conversation.

Here are some examples:

* *"Find my top ten content gaps and create a brief for each one."*
* *"Run a site audit and give me a plain-language summary of the most critical issues."*
* *"Research this keyword, build a brief, and write a draft optimized for AI visibility."*
* *"Which of my published articles are showing signs of content decay?"*
* *"Create a content cluster around email marketing — pillar page plus five supporting article briefs."*
* *"What should I publish next based on my current opportunities?"*

### Connect via Claude Directory *(Fastest)*

You can find the Frase MCP in the Claude Directory [here](https://claude.ai/customize/connectors/directory/frase). Simply click **Connect**, choose your Frase account, and voila!

{% hint style="success" %}
**What to expect your first time:** Claude asks permission the first time it uses each Frase tool, tells you what it's doing as it works, and checks with you before publishing or making changes.
{% endhint %}

### Connect via Claude Code *(Backup)*

Claude Code is Anthropic's command-line tool that lets Claude work directly with tools and services on your behalf. It's the environment where the Frase MCP connection runs.

Here's how to set it up:

{% stepper %}
{% step %}

### **Install Claude Code**

Claude Code runs in your computer's terminal.

Go to [claude.ai/code](https://claude.ai/code) and follow the installation instructions for your operating system. You'll need Node.js installed on your computer first. If you don't have it, the Claude Code setup page will point you to where to download it (it's free).
{% endstep %}

{% step %}

### **Connect the Frase MCP Server**

With Claude Code installed, run the following command in your terminal — replacing the placeholder at the end with your actual Frase API key:

```
claude mcp add frase -- npx -y @frase/mcp-server --api-key sk_live_your_api_key
```

To find your API key, go to **Settings → API Keys** inside Frase and copy it. Once you run this command, Claude Code will automatically start the Frase server whenever it's needed. You only need to do this once.
{% endstep %}

{% step %}

### **Start a Session**

Once the setup is complete, open Claude and start a conversation. The Frase MCP server runs in the background automatically.

To confirm everything is connected, try this as your first message:

*"List my connected Frase sites."*

If Claude responds with your site names, you're ready to go.
{% endstep %}
{% endstepper %}

### Requests to Try

Here are some good starting requests to get a feel for what's possible:

1. **Start with something low-stakes and informational** — *"What are my top content opportunities right now?"* — to see how Claude interprets your data and presents results.
2. **Then try a creation request** — *"Research \[your keyword] and create a brief"* — to see the full research-to-brief workflow run.
3. **Then try something analytical** — *"Which of my pages are ranking between position four and ten and are worth optimizing?"* — to see how Claude uses your Search Console data.

From there, the workflows you'll find most valuable will depend on your own content operation — what's most repetitive and what takes the most time.

### For Developers and Technical Teams

If want to explore the full technical capabilities of the Frase MCP server and API, the complete documentation is available below:

* [MCP Server](https://npmjs.com/package/@frase/mcp-server)
* [API Documentation](https://next.frase.io/api/docs)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.frase.io/automations/automate-with-frase-mcp.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.