AI assistants (MCP)

ChatFeatured runs an MCP (Model Context Protocol) server. Connect an AI assistant to it and the assistant can read your AI search analytics, manage prompts, competitors and your brand book, and create, schedule and publish articles in any project you have access to. The setup page is Integrations → AI Assistants (MCP). The connection acts as you, with your role in every workspace and project you can open. Project data needs an active or trialing plan on the project’s workspace.

Server URL

https://chatfeatured.com/api/mcp

The server uses the Streamable HTTP transport. If your client asks, choose HTTP, not SSE.

Connect with OAuth (recommended)

Add the URL and your client opens a ChatFeatured sign-in page. No key, client ID or secret is needed.

Claude
Claude Code
ChatGPT
Cursor

In Claude (web or desktop), go to Settings → Connectors → Add custom connector, paste the server URL, and sign in with your ChatFeatured account.

claude mcp add --transport http chatfeatured https://chatfeatured.com/api/mcp

Then run /mcp in Claude Code and sign in when prompted.

Add the server to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json in a project:

{
  "mcpServers": {
    "chatfeatured": {
      "url": "https://chatfeatured.com/api/mcp"
    }
  }
}

Cursor opens a browser to sign in the first time it connects.

Signed-in clients appear under Connected assistants. Click the trash icon to disconnect one.

Connect with an API key

Use an API key for clients that don’t support OAuth, and for scripts.

Go to Integrations → AI Assistants (MCP) and scroll to API Keys.
Click Create API Key, give it a Name, and click Create Key.
Copy the key from the API Key Created dialog. You won’t see it again.

The key has access to all projects you can access. Send it in an x-api-key header, as Authorization: Bearer cf_..., or as an ?api_key= query parameter. Most clients take a config like this one, shown in the dashboard under Add to your client:

{
  "mcpServers": {
    "chatfeatured": {
      "url": "https://chatfeatured.com/api/mcp",
      "headers": {
        "x-api-key": "cf_your_key_here"
      }
    }
  }
}

For Claude Code:

claude mcp add --transport http chatfeatured https://chatfeatured.com/api/mcp \
  --header "x-api-key: cf_your_key_here"

From your own code, use any MCP client library with a Streamable HTTP transport. With the official TypeScript SDK (@modelcontextprotocol/sdk):

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const transport = new StreamableHTTPClientTransport(
  new URL("https://chatfeatured.com/api/mcp"),
  { requestInit: { headers: { "x-api-key": process.env.CHATFEATURED_API_KEY } } }
);
const client = new Client({ name: "my-script", version: "1.0.0" });
await client.connect(transport);

const result = await client.callTool({
  name: "list_organizations",
  arguments: {},
});
console.log(result.content);

The API Keys list shows your MCP keys. Click the trash icon to delete one; clients using it lose access immediately. MCP keys and project REST API keys aren’t interchangeable.

Rate limit for API keys

Each API key allows 100 requests per minute, counting every message your client sends, including tool listings. Over the limit, the server answers 429 Too Many Requests. OAuth connections don’t have this limit.

How a session works

Tool and field names say “brand” where the dashboard says “project”. A brandId is a project ID.

list_organizations, then list_brands, to find the project. Pass its ID as brandId to every other tool.
get_brand_brief for how the project is doing. Drill in with query_analytics, or query_analytics_sql for questions the presets can’t answer.
create_article_ideas, then approve_articles to start writing. Approval counts against your monthly article limit.
list_articles with status: "review" to see which drafts are ready (writing takes a few minutes), then get_article to read one as Markdown.
list_integrations, then publish_article or schedule_article. With more than one destination, pass the integrationId. get_publish_status confirms the article reached the CMS.

The assistant can’t edit an article’s body; do that in the dashboard editor. To publish somewhere ChatFeatured isn’t connected to, read the article with get_article, publish it yourself, then call update_article_status with status: "published" and the live URL in externalUrls so it’s tracked for citations. Tools that use plan allowances (approve_articles, create_prompt, update_prompt, update_prompt_status) report what’s left in their responses. get_organization_usage shows every limit at once.

Tools

Workspaces, projects and usage

Tool	What it does
`list_organizations`	Lists the workspaces you belong to and your role in each.
`list_brands`	Lists the projects you can access. Returns the ID to pass as `brandId`.
`get_organization_usage`	A workspace’s plan and usage against every limit. Owners and Admins only.

Analytics

Tool	What it does
`get_brand_brief`	One summary for a period versus the one before: Visibility, sentiment, mentions, citations, platforms, competitor ranking, prompt movers and cited domains.
`query_analytics`	Slices AI search metrics by prompt, model, competitor, cited page or domain, country and date.
`query_analytics_sql`	Runs one read-only SQL query over the project’s AI search data. Call it with `explain: true` first to get the schema.
`query_crawler_analytics`	AI crawler and agent visits to your site. Needs a connected agent analytics source.
`query_google_analytics`	Reads the project’s connected Google Analytics 4 property.
`query_search_console`	Reads the project’s connected Search Console property.
`get_response_text`	Returns what AI models answered to your prompts.

Site audit

Tool	What it does
`query_site_audit`	Reads your site audit: overview, lowest-scoring pages, open issues, one page’s detail, or recent runs.

Prompts

Tool	What it does
`list_prompts`	Lists tracked prompts with status, countries and tags.
`create_prompt`	Adds a prompt to track. Defaults to the US. Uses one prompt slot per country.
`score_prompt_demand`	Returns a demand band for candidate prompt text, without creating anything.
`set_prompt_keyword`	Links or unlinks keywords on a prompt.
`update_prompt`	Changes a prompt’s countries or tags. The text can’t be changed.
`update_prompt_status`	Pauses or resumes prompts.

Brand book

Tool	What it does
`get_brand_book`	Reads the brand book.
`update_brand_book`	Changes the brand book fields you pass.
`manage_brand_persona`	Lists, creates, updates or deletes personas.

Keywords

Tool	What it does
`fetch_keywords`	Lists the keywords in the project’s keyword bank.
`research_keywords`	Gets keyword ideas for a phrase or website, without adding them.
`add_keywords`	Adds keywords to the bank.

Knowledge base

Tool	What it does
`knowledge_base_read`	Reads knowledge base documents in full.
`knowledge_base_query`	Searches the knowledge base and returns matching excerpts.

Opportunities and tasks

Tool	What it does
`get_existing_opportunities`	Lists opportunities found in the last 30 days.
`add_opportunity_task`	Adds opportunities to your Tasks page.
`list_tasks`	Lists tasks, filtered by status or type.
`update_task_status`	Marks a task open, in progress, completed or dismissed.

Articles

Tool	What it does
`list_articles`	Lists articles with ID, title, status and creation date.
`get_article`	Reads one article, with the body as Markdown.
`create_article_ideas`	Saves article ideas with their linked keywords, prompts and tasks.
`approve_articles`	Approves ideas and starts writing them.
`generate_articles`	Restarts writing for an approved article whose generation stalled. Don’t call it right after `approve_articles`.
`update_article_content`	Changes the title, description, “why” and keyword and prompt links. Not the body.
`update_article_status`	Sets the status to review, awaiting approval, approved or published. Never pushes to a CMS.
`archive_articles`	Archives articles and dismisses their tasks.
`unarchive_article`	Restores an archived article.
`delete_articles`	Deletes articles permanently. Copies in an external CMS stay there.
`schedule_article`	Schedules, reschedules or cancels a publish date. The article must be in review. Pass `integrationId` to pick the CMS.
`get_article_schedule`	Shows when an article is scheduled to publish.

Publishing

Tool	What it does
`list_integrations`	Lists the project’s publishing destinations, including the Blog CMS when it’s live, with authors and tags.
`publish_article`	Publishes an article to one destination. Pass `integrationId` when there are several.
`get_publish_status`	Checks whether an article reached its CMS, with its external URL.
`search_pexels_images`	Searches Pexels for a featured image.
`set_article_featured_image`	Sets a Pexels photo as the article’s featured image.

Topics and competitors

Tool	What it does
`list_tags`	Lists the project’s topics (tags).
`manage_tag`	Creates, renames, recolors or deletes a topic, or changes which prompts it’s on.
`list_competitors`	Lists the project’s competitors.
`manage_competitor`	Adds, updates or removes a competitor and the brand names that count as it.

Troubleshooting

"Access denied: this project does not have an active ChatFeatured plan"

The project’s workspace has no active or trialing plan. list_organizations and list_brands still work.

"Access denied: you do not have access to this project"

The brandId belongs to a project you aren’t a member of. Check it against list_brands.

401 "Invalid or expired credentials"

With an API key, check it wasn’t deleted, that you copied all of it, and that it’s an MCP key rather than a REST API key. With OAuth, disconnect the assistant under Connected assistants and connect it again.

403 "MCP access requires organization membership"

Your account isn’t in any workspace. Ask a workspace Owner to invite you.

Getting started

Using ChatFeatured

Index submissions

AI agent

Integrations

Account

Server URL

Connect with OAuth (recommended)

Connect with an API key

Rate limit for API keys

How a session works

Tools

Workspaces, projects and usage

Analytics

Site audit

Prompts

Brand book

Keywords

Knowledge base

Opportunities and tasks

Articles

Publishing

Topics and competitors

Troubleshooting

​Server URL

​Connect with OAuth (recommended)

​Connect with an API key

​Rate limit for API keys

​How a session works

​Tools

​Workspaces, projects and usage

​Analytics

​Site audit

​Prompts

​Brand book

​Keywords

​Knowledge base

​Opportunities and tasks

​Articles

​Publishing

​Topics and competitors

​Troubleshooting

Server URL

Connect with OAuth (recommended)

Connect with an API key

Rate limit for API keys

How a session works

Tools

Workspaces, projects and usage

Analytics

Site audit

Prompts

Brand book

Keywords

Knowledge base

Opportunities and tasks

Articles

Publishing

Topics and competitors

Troubleshooting