Pro · MCP server

Ghost Act inside your assistant

Check a draft without leaving the chat: the verdict, the reasons, which parts read differently, and your words left. Part of Pro.

Server URLhttps://mcp.ghostact.com/mcp

Connect your assistant

Add to Claude

In Claude, open Customize → Connectors, choose +, then Add custom connector. The button above opens it for you.
Name it Ghost Act and paste the server URL: https://mcp.ghostact.com/mcp
Choose Connect, sign in with your Ghost Act email and the 6-digit code we send you, and allow access.
In a chat, open the + menu, then Connectors, and switch Ghost Act on.

Works on claude.ai, the desktop app and the mobile apps once added. The free Claude plan allows one custom connector.

In ChatGPT, open Settings → Security and login and turn on Developer mode.
Go to chatgpt.com/plugins and choose +.
Name it Ghost Act and, under Connection, enter the server URL: https://mcp.ghostact.com/mcp
Sign in with your Ghost Act email and the 6-digit code we send you, and allow access.
Start a new chat and add Ghost Act from the tools menu.

ChatGPT connects by signing in; it doesn’t use API keys. Developer mode depends on your plan and your workspace’s settings.

Add to Cursor

Cursor then asks you to sign in with your Ghost Act email. Or add it to ~/.cursor/mcp.json yourself:

{
  "mcpServers": {
    "ghostact": {
      "url": "https://mcp.ghostact.com/mcp"
    }
  }
}

With an API key instead of signing in (create one below):

{
  "mcpServers": {
    "ghostact": {
      "url": "https://mcp.ghostact.com/mcp",
      "headers": {
        "Authorization": "Bearer gact_your_key"
      }
    }
  }
}

Install in VS Code

Or add it to .vscode/mcp.json in your project. VS Code asks you to sign in when Ghost Act is first used.

{
  "servers": {
    "ghostact": {
      "type": "http",
      "url": "https://mcp.ghostact.com/mcp"
    }
  }
}

In a terminal:

claude mcp add --transport http ghostact https://mcp.ghostact.com/mcp --scope user

Then run /mcp in Claude Code and choose ghostact to sign in.

With an API key instead (set GHOSTACT_KEY first):

claude mcp add --transport http ghostact https://mcp.ghostact.com/mcp --scope user --header "Authorization: Bearer $GHOSTACT_KEY"

In a terminal:

gemini mcp add --transport http --scope user ghostact https://mcp.ghostact.com/mcp

Then run /mcp auth ghostact in Gemini CLI to sign in.

With an API key instead, in ~/.gemini/settings.json (note "httpUrl", not "url"):

{
  "mcpServers": {
    "ghostact": {
      "httpUrl": "https://mcp.ghostact.com/mcp",
      "headers": {
        "Authorization": "Bearer gact_your_key"
      }
    }
  }
}

Your connections

Things to ask

Check my essay with Ghost Act.
Which sentences have the most style marks, and why?
I’ve revised it. Check again.
How many Ghost Act words do I have left?

Tools

Tool	What it does	Uses words
`analyse_text`	The verdict and AI likelihood, parts that read differently, and the sentences with the most style marks, with the reason for each. A re-check of a revised draft says what changed.	Uses words: Yes. A re-check uses only the new words.
`get_usage`	Your plan, words left and when your words renew.	Uses words: No
`watermark_test`	Ghost Act’s open SynthID-style and KGW tests with a key you supply. It can’t detect Claude, Gemini or ChatGPT watermarks.	Uses words: Yes, like analyse_text
`watermark_capacity`	How much any watermark check can show on this text.	Uses words: Yes, like analyse_text

Limits

Up to 20,000 words per check. For longer work, check it chapter by chapter.
Tuned for English. Other languages get exact counts and marks, but no calibrated verdict.
The language model reads about the first 3,000 words, as on the website; style is checked throughout.
Claude’s, Gemini’s and ChatGPT’s watermarks are keyed or absent, so no outside tool can detect them. Ghost Act doesn’t try.
It can’t tell you what another detector will say.
It never rewrites your text. It explains what it found so you can revise it yourself.

Every result is statistical evidence, never proof of who wrote a text.

Privacy

With Pro’s assistant connection, your assistant sends the text to Ghost Act’s server in Western Europe, which analyses it in memory. It is never stored, logged or used for training. So that re-checks charge only new words, an encrypted word tally that only your chat can unlock is kept for 7 days. Your assistant’s provider also processes the text under its own terms. On ghostact.com itself, nothing leaves your browser.

Troubleshooting

The word count doesn’t match my document

Your assistant sends the text it has; if the count is short, it didn’t send all of it. Paste the full text into the chat, or ask it to check the whole document exactly as written.

A long essay takes a while

The assistant has to write the whole text out to send it, which can take a minute for a long essay. Scoring itself takes a few seconds.

How do I sign in?

With the email you use for Ghost Act Pro. We email you a 6-digit code; there’s no password. The connection then stays signed in until you disconnect it here.

It says I’m out of words

Each check uses words from your Pro allowance, then any word packs. Top up on ghostact.com and the next check works straight away.