Log in Start now

Documentation

MCP server

Use the Krastie MCP server to call the public API from Cursor, Claude Desktop, and other MCP clients.

   
                                      
                 
                                                                                                                  
   

# MCP server

The Krastie MCP server exposes the [public API](/docs) as tools for MCP-compatible clients such as Cursor and Claude Desktop. Every tool call authenticates with your API key.

## Prerequisites

- A Krastie API key on **Business**, **Growth**, or **Enterprise** — create one under **Integrations → Krastie API**

See [Authentication](/docs/authentication) for plan requirements and the `api-key` header.

## Cursor

Add a project or user config (`.cursor/mcp.json` or `~/.cursor/mcp.json`):

```json
{
  "mcpServers": {
    "krastie": {
      "url": "https://api.krastie.ai/v1/mcp",
      "headers": {
        "api-key": "krastie_YOUR_KEY"
      }
    }
  }
}
```

Reload MCP servers in Cursor settings, then ask the agent to use Krastie tools (for example, generate text or list brand voices).

## Claude Desktop

Add the same `mcpServers.krastie` entry to Claude Desktop’s MCP config, with your `api-key` header.

## Authentication

Send your full `krastie_…` key in the `api-key` header on every MCP request. OAuth is currently not supported for this MCP.

Store keys in your client’s secrets manager — never commit them.

## Available tools

Tools map 1:1 to public API routes:

| Tool | API |
|------|-----|
| `generate_text` | [Generate text](/docs/api-reference/ai-generation#generate-text) |
| `generate_chat` | [Generate chat](/docs/api-reference/ai-generation#generate-chat-message) |
| `generate_image` | [Generate image](/docs/api-reference/ai-generation#generate-image) |
| `get_job` | [Async jobs](/docs/api-reference/jobs) |
| `list_brand_voices` | [List brand voices](/docs/api-reference/brand-voice#list-brand-voices) |
| `get_brand_voice` | [Get a brand voice](/docs/api-reference/brand-voice#get-a-brand-voice) |
| `create_brand_voice_from_website` | [Brand voice from website](/docs/api-reference/ai-generation#brand-voice-from-website) |
| `list_chat_sessions` | [List sessions](/docs/api-reference/chat-sessions#list-sessions) |
| `run_visibility_report` | [Run a visibility report](/docs/api-reference/ai-visibility#run-a-visibility-report) |
| `get_visibility_report` | [Get the latest report](/docs/api-reference/ai-visibility#get-the-latest-report) |
| `get_visibility_history` | [Get visibility history](/docs/api-reference/ai-visibility#get-visibility-history) |
| `list_ai_traffic_sites` | [List sites](/docs/api-reference/ai-traffic#list-sites) |
| `get_ai_traffic_stats` | [Get stats](/docs/api-reference/ai-traffic#get-stats) |
| `get_assistant_context` | [Assistant workspace context](/docs/api-reference/ai-generation#assistant-workspace-context) |

Request and response shapes match the linked API reference. Rate limits and errors are the same as the REST API — see [Errors & rate limits](/docs/api-reference/errors-and-limits).

## Example prompts

- “Generate a two-sentence product intro with Krastie using gpt-4o.”
- “List my brand voices.”
- “Queue an AI visibility report for https://example.com.”
- “Show AI traffic stats for the last 30 days.”

MCP server

The Krastie MCP server exposes the public API as tools for MCP-compatible clients such as Cursor and Claude Desktop. Every tool call authenticates with your API key.

Prerequisites

A Krastie API key on Business, Growth, or Enterprise — create one under Integrations → Krastie API

See Authentication for plan requirements and the api-key header.

Cursor

Add a project or user config (.cursor/mcp.json or ~/.cursor/mcp.json):

{
  "mcpServers": {
    "krastie": {
      "url": "https://api.krastie.ai/v1/mcp",
      "headers": {
        "api-key": "krastie_YOUR_KEY"
      }
    }
  }
}

Reload MCP servers in Cursor settings, then ask the agent to use Krastie tools (for example, generate text or list brand voices).

Claude Desktop

Add the same mcpServers.krastie entry to Claude Desktop’s MCP config, with your api-key header.

Authentication

Send your full krastie_… key in the api-key header on every MCP request. OAuth is currently not supported for this MCP.

Store keys in your client’s secrets manager — never commit them.

Available tools

Tools map 1:1 to public API routes:

Tool	API
`generate_text`	Generate text
`generate_chat`	Generate chat
`generate_image`	Generate image
`get_job`	Async jobs
`list_brand_voices`	List brand voices
`get_brand_voice`	Get a brand voice
`create_brand_voice_from_website`	Brand voice from website
`list_chat_sessions`	List sessions
`run_visibility_report`	Run a visibility report
`get_visibility_report`	Get the latest report
`get_visibility_history`	Get visibility history
`list_ai_traffic_sites`	List sites
`get_ai_traffic_stats`	Get stats
`get_assistant_context`	Assistant workspace context

Request and response shapes match the linked API reference. Rate limits and errors are the same as the REST API — see Errors & rate limits.

Example prompts

“Generate a two-sentence product intro with Krastie using gpt-4o.”
“List my brand voices.”
“Queue an AI visibility report for https://example.com.”
“Show AI traffic stats for the last 30 days.”