Usage & Integration
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
Note: It is recommended, especially for longer texts, to use ChatGPT's 'Work' mode as it excels at extended, autonomous functionality.
Connecting your account
Until Originality.ai is available as an official listed plugin in ChatGPT, you can connect directly to the Originality.ai MCP server using its MCP server URL.
Originality.ai MCP Server URL:
https://mcp.originality.ai/mcp
1. Open ChatGPT on the web.
2. Open Settings → Security and Login.
3. Enable Developer Mode.
4. Exit settings if there, and then go to Plugins and then click Add and then click Create MCP App.
5. Title the custom plugin with an appropriate name like Originality.ai.
6. Under Connection, enter the Originality.ai MCP server URL:
https://mcp.originality.ai/mcp
7. Make sure Authentication is set to OAuth.
8. Click the Create button.
9. Sign in to your Originality.ai account.
After connecting, enable Originality.ai for a new conversation or mention it in your prompt.
Availability of custom MCP apps and Developer Mode depends on your ChatGPT plan and, for managed workspaces, your organization's settings. If the option to create a custom app is unavailable, your workspace administrator may need to enable access.
Note: If you have issues running the plugin, try refreshing the plugin connection and the browser tab.
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 5.0 to check this text for AI-assisted writing: [paste text]."
"@originality.ai Scan this text using 5.0 Max and report whether it is Original, AI, or Mixed: [paste text]."
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.
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.
Note: If after entering the terminal command, you are redirected to the logged in homepage and the terminal does not mention successful completion, please try logging out from your Originality.ai account prior to entering the command.
Using Originality.ai with Claude
Claude.ai and Claude Desktop are another option for the recommended experience for the Originality.ai MCP Server.
Until Originality.ai is available in Claude's Connectors Directory, you can connect directly to the Originality.ai MCP Server using its MCP server URL.
Connecting your account
Originality.ai MCP Server URL:
https://mcp.originality.ai/mcp
Individual accounts
1. In Claude, go to Customize → Connectors.
2. Click the + Add button in the Connectors tab.
3. Select Add custom connector.
4. Enter a name for the connector, such as Originality.ai.
5. Enter the Originality.ai MCP server URL:
https://mcp.originality.ai/mcp
6. Click Continue.
7. Leave the settings for Authentication and OAuth Client to their defaults.
8. Click Add button.
9. Find Originality.ai in your connectors and click Connect.
10. Complete the Originality.ai sign-in and authorization process in your browser.
11. Review the requested permissions and approve the connection.
Team and Enterprise accounts
On Claude Team and Enterprise plans, an Owner or Primary Owner must first add the custom connector for the organization.
The Owner can:
1. Go to Organization settings → Connectors.
2. Click + Add.
3. Select Custom → Web.
4. Continue with steps 4 to 8 in the above instructions for an individual account.
Once Originality.ai has been added to the organization, individual users can go to Customize → Connectors, find Originality.ai, and click Connect to sign in and authorize their own Originality.ai account.
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 5.0 to check this text for AI-assisted writing: [paste text]."
"@originality.ai Scan this text using 5.0 Max and report whether it is Original, AI, or Mixed: [paste text]."
The same supported text-length requirements, and credit usage described above apply when using Claude.
Claude Code
Install the connector via Claude Desktop or Claude.ai.
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
Note: If the .gemini/config directory or mcp_config.json file does not already exist, create them.
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.
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:
- Connect to the MCP server.
- Discover that authentication is required.
- Discover the Originality.ai authorization metadata.
- Identify itself to the authorization server.
- Open a browser so you can sign in and approve access.
- Receive an access token.
- Use that token when calling the Originality.ai MCP tools.
On this page
- Usage & Integration