MCP Server

## Sections
• [Introduction](https://mcp.docs.originality.ai/introduction.md): The Originality.ai MCP Server lets AI assistants such as ChatGPT and Claude check text for likely AI-generated content directly from a conversation. Once connected, you can paste text into a chat, choose an AI allowance or use our multi language model for non-English text, and receive an Originality.ai result without switching applications. Results include the classification, confidence, AI and human scores, and a link to the complete scan in Originality.ai. What is an MCP Server? MCP stands for Model Context Protocol . It is an open standard that allows AI applications to connect to external services and tools. In simple terms: You → your AI assistant → Originality.ai MCP Server → Originality.ai The AI assistant decides when an Originality.ai tool is useful, sends an authorized request to the MCP server, and uses the result in your conversation.You remain signed in as yourself. Access is limited to your Originality.ai account and the permissions you approve. Scan availability and credit usage depend on your account.
• [Prerequisites](https://mcp.docs.originality.ai/prerequisites.md): In order to use Originality.ai's MCP server you will require: An AI agent of your choice that supports CIMD (Client Id Metadata Documents). An Originality.ai owner account. An Originality.ai paid subscription with available credits (purchased at https://originality.ai/pricing ). See our Supported Agents section for a list of agents tested by our Originality.ai team.
• [Usage & Integration](https://mcp.docs.originality.ai/usage-and-integration.md): 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 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. 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 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: 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. 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. 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. Hermes 1. Add the Originality.ai MCP server Open Hermes Agent and go to Capabilities → MCP . Add the following configuration to mcp.json : 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: JSON { "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.
• [Troubleshooting & FAQ](https://mcp.docs.originality.ai/troubleshooting-and-faq.md): What is CIMD? CIMD stands for Client ID Metadata Documents . It is an authentication setup mechanism between an MCP client and Originality.ai. Most users will never need to interact with it directly. Traditionally, an OAuth application must register with a service before it can connect. The service gives the application a client ID and stores information such as its permitted callback URLs. That model becomes difficult with MCP because many different AI applications may want to connect to the same MCP server. CIMD provides another approach. Instead of requiring Originality.ai to preregister every supported MCP client, the client can identify itself using an HTTPS URL. That URL contains a metadata document describing the client, including its name and approved redirect URLs. In simplified form: MCP client → provides its metadata URL → Originality.ai verifies the metadata → you sign in → the connection is authorized This allows compatible MCP clients to connect without Originality.ai creating a separate OAuth registration for every client. Is CIMD specific to ChatGPT and Claude? No. CIMD is an OAuth client-registration mechanism used by Originality.ai’s MCP server. ChatGPT, Claude, and any other MCP client that supports CIMD can use it. The sign-in experience remains familiar: your browser opens, you sign in to Originality.ai, approve access, and return to your MCP client. What if my MCP client does not support CIMD? Support varies between MCP clients and versions. If a client supports CIMD, client registration can normally happen automatically. If it does not support CIMD , it is unfortunately incompatible with Originality.ai's MCP server. Check your MCP client's documentation for CIMD or Client ID Metadata Document support. What if the result card does not appear? The absence of the interactive result card does not necessarily mean the MCP connection failed . If your AI client can call the Originality.ai tools and receive scan results, authentication and the MCP connection are working. The client may simply not support the interactive interface used by Originality.ai. Troubleshooting I am being asked to sign in This is expected when connecting Originality.ai for the first time or when a previous authorization has expired. Complete the sign-in and authorization process in your browser. My MCP client says authentication is unsupported Make sure your client supports: Remote MCP servers OAuth authentication for MCP Client ID Metadata Documents (CIMD) Older MCP clients may not support the required authorization features. My text cannot be scanned Make sure the text contains between 100 and 50,000 words. If you have made many requests in a short period, wait a few minutes and try again. If you receive an Insufficient credits message, check the available credits in your Originality.ai account. Team members must also have access to the required account credits. The tool returns results as text, but the interactive result card is not displayed. Your client may support MCP tools but not the interactive interface used by Originality.ai. I previously connected successfully, but it stopped working Disconnect and reconnect Originality.ai from your MCP client. This starts a new authorization flow and can resolve an expired or revoked authorization. If issues still persist, try fully uninstalling and reinstalling the MCP server. Frequently asked questions What do I need to do to use the MCP server? You'll need a compatible AI agent as well as an Originality.ai account with credits purchased at https://originality.ai/pricing or by clicking the Buy Subscription when signed in on https://app.originality.ai . Do I need to understand MCP to use Originality.ai's MCP server? No. Once the connection is configured, you can use Originality.ai by speaking naturally to your AI assistant. Which AI allowance percentages can I use? The supported allowances are 0%, 5%, 15%, 25%, 40%. If you do not specify one, the default is 15%. Can I compare multiple allowances for the same text? Yes. Ask the assistant to check the same text at two or more supported allowances. It will create the initial scan and reuse it for the additional allowance results. Can I use Originality.ai's MCP server without the interactive result card? Yes, provided your client supports Originality.ai MCP tools and authentication requirements. Will every MCP client work? No. MCP clients differ in the parts of the MCP specification and optional extensions they support. ChatGPT and Claude are the recommended clients for the complete Originality.ai experience. Other clients may support some or all functionality.
• [Supported Agents](https://mcp.docs.originality.ai/supported-agents.md): The Originality.ai MCP Server has been tested with the following AI agents. Other AI Agents may work depending on their compability. ChatGPT Claude Web & Desktop Codex Claude Code Hermes Anti-Gravity Note: The UI widget seen in chats may not be available in your AI agent. It is confirmed to be available for ChatGPT and Claude.