Using Originality.ai with ChatGPT

ChatGPT provides one of the recommended and fully supported experiences for the Originality.ai MCP Server.

In ChatGPT, Originality.ai provides:

• MCP tools that ChatGPT can call on your behalf
• An interactive result card showing the scan verdict, confidence, score split, AI allowance, and a link to the full scan

Connecting your account

1. Open the ChatGPT Plugins Directory

2. Find Originality.ai by searching by name or in the Productivity section.

3. Install the plugin.

4. Sign in to your Originality.ai account.

5. Review the requested permissions.

6. Approve the connection.

After connecting, enable Originality.ai for a new conversation or mention it in your prompt.

Using it in a conversation

Ask ChatGPT what you want to accomplish in normal language. You do not need to call MCP tools yourself.

For example:

"Use originality.ai to check this text with a 15% allowance: [paste text]."

"@originality.ai Check whether this text exceeds a 5% AI allowance: [paste text]."

"Scan this text at 0%, 15%, and 40% AI allowance and compare the results: [paste text]."

Originality.ai supports AI allowances of 0%, 5%, 15%, 25%, and 40%. If you do not specify an allowance, the server uses 15%. 

Text must contain between 100 and 50,000 words. 

When you request multiple allowances for the same text, ChatGPT creates one scan and checks the additional allowances against the scan. Each successful result includes a View full scan link to the complete result in your Originality.ai account. 

Available tools

The Originality.ai MCP Server currently provides three tools:

• AI allowance scan (ai_allowance_scan) - Creates a new scan for supplied text using an AI allowance of 0%, 5%, 15%, 25%, or 40%. The default is 15%.
• AI allowance rescan (ai_allowance_rescan) - checks an additional allowance for text from an existing scan. It reuses the original scan ID and returns an existing result when available.
• Multi language scan (multi_lang_scan) - Runs AI detection using the Multi language model for non-English text. It does not use allowance thresholds and cannot be rescanned with ai_allowance_rescan.

You normally do not need to select these tools yourself. Ask your AI assistant in normal conversational language in a way that would make sense for the appropriate tool(s) to be chosen. Successful results include a link to the full scan in Originality.ai. 

The interactive result card

Originality.ai scan tools can display an interactive result card directly inside ChatGPT and Claude. The card includes:

• Whether the text falls within or exceeds the selected AI allowance
• The AI and human-written score split
• The confidence level
• The selected AI allowance (for AI Allowance scans)
• The word length and time of scan
• A link to the completed scan in Originality.ai 

The interactive result card is currently supported and tested with ChatGPT and Claude.

The underlying MCP tools are separate from the card. Another MCP client may still be able to run Originality.ai scans even if it cannot display the same interface.

Using Originality.ai with Claude

Claude.ai and Claude Desktop are another option for the recommended experience for the Originality.ai MCP Server.

Connecting your account

1. Go to Settings and then Connectors.

2. Click Discover and search Originality.ai or find it in the Productivity section.

3. Click the + button ("Connect to Claude").

4. Complete the Originality.ai sign-in and authorization process in your browser.

5. Review the requested permissions and approve the connection.

Using it in a conversation

In a Claude conversation, open Search and tools and enable Originality.ai or the specific Originality.ai tools you want Claude to use. You can then ask Claude to scan text in normal language.

For example:

"Use Originality.ai to check this text with a 15% allowance: [paste text]."

"Check whether this text exceeds a 5% AI allowance using Originality.ai: [paste text]."

"Scan this text at 0%, 15%, and 40% AI allowance and compare the results: [paste text]."

The same supported allowances, default allowance, multi language, text-length requirements, and credit usage described above apply when using Claude. For multiple allowances, Claude can create the initial scan and reuse its scan ID for the additional checks.

Using Originality.ai with other MCP clients

Originality.ai is an MCP server rather than a ChatGPT or Claude only API. Other applications that support remote MCP servers may therefore be able to connect to it.

The exact setup depends on the MCP client. Use the following server URL:

https://mcp.originality.ai/mcp 

A compatible client should then:

1. Connect to the MCP server.
2. Discover that authentication is required.
3. Discover the Originality.ai authorization metadata.
4. Identify itself to the authorization server.
5. Open a browser so you can sign in and approve access.
6. Receive an access token. 
7. Use that token when calling the Originality.ai MCP tools.

Specific Examples

Claude Code

Install the connector via Claude Desktop or Claude.ai (See Above).  

Codex

  1. Make sure the the Codex CLI is installed on your device (https://learn.chatgpt.com/docs/codex/cli) 

  2. Open your terminal and enter the following command:

   codex mcp add originality-ai --url https://mcp.originality.ai/mcp 

  3. Sign In to your Originality.ai account and authorize the service.

  4. Return to Codex and start a new chat.

Hermes

1. Add the Originality.ai MCP server

Open Hermes Agent and go to Capabilities → MCP.

Add the following configuration to mcp.json:

 
{
  "mcpServers": {
    "originality-ai": {
      "url": "https://mcp.originality.ai/mcp",
      "auth": "oauth"
    }
  }
}

Save your changes.

2. Connect your Originality.ai account

Open a terminal and run:

hermes mcp login originality-ai

This starts the OAuth authentication process for the Originality.ai MCP server.

Windows

Open PowerShell and run:

hermes mcp login originality-ai

If hermes isn't recognized, run the Hermes executable directly:

& "$env:LOCALAPPDATA\hermes\bin\hermes.exe" mcp login originality-ai

macOS

Open Terminal and run:

hermes mcp login originality-ai

If hermes isn't recognized, close and reopen Terminal and try the command again.

If it is still unavailable, install the Hermes CLI using the official Hermes installer:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Then open a new Terminal window and run:

hermes mcp login originality-ai

3. Authorize Originality.ai

Hermes will open an authorization page in your browser.

Sign in to your Originality.ai account if prompted, then approve the connection.

Once authorization succeeds, return to Hermes.

4. Restart Hermes Agent

Restart Hermes Agent so that the connected Originality.ai MCP tools are loaded.

You can now use the Originality.ai tools from within Hermes Agent.

Anti-Gravity

1. Open the MCP configuration file

Windows:

Open:

%USERPROFILE%\.gemini\config\mcp_config.json

For example:

C:\Users\YourName\.gemini\config\mcp_config.json

macOS/Linux:

Open:

~/.gemini/config/mcp_config.json

2. Add the Originality.ai MCP server

Add the following JSON configuration:

 
{
  "mcpServers": {
    "originality-ai": {
      "serverUrl": "https://mcp.originality.ai/mcp"
    }
  }
}

If your mcp_config.json file already contains other MCP servers, add the originality-ai entry to the existing mcpServers object rather than replacing the existing configuration.

3. Save the configuration

Save and close the mcp_config.json file.

4. Refresh MCP servers in Anti-Gravity

Open the Anti-Gravity desktop app.

Navigate to Customizations, scroll down to Installed MCP Servers, and click Refresh.

The originality-ai MCP server should now appear in the list.

Click Authenticate.

5. Authenticate with Originality.ai

Complete the authentication flow in your browser.

Once authentication is successful, return to Anti-Gravity. The Originality.ai MCP server should now be connected and ready to use.

Compatibility with other clients

There are two separate compatibility questions.

Can the client use the MCP tools?

A compatible MCP client should be able to discover and call the tools exposed by Originality.ai. It must support remote MCP servers, OAuth authentication for MCP, and the CIMD client registration method used by Originality.ai.

Can the client display the interactive result card?

Not necessarily. 

Interactive interfaces are an additional MCP capability. Clients that support the relevant MCP Apps functionality may be able to display the result card. Clients without that support can still use the underlying tools and receive text and structured results.

The interactive Originality.ai result card is confirmed for ChatGPT and Claude. Support in other MCP clients is client-dependent unless Originality.ai specifically lists the client as supported.