MCP Overview

oper8r exposes tools through MCP so agent clients can search your knowledge base, answer questions with citations, and draft RFP or security questionnaire responses.

MCP is useful when your team already works in ChatGPT, Claude, Claude Code, Codex, Cursor, or another agent client and wants that client to use oper8r context safely.

Setup Guide

Follow these steps to connect your agent client to oper8r, install the matching skills, and confirm that it can retrieve and cite your organization's knowledge.

1. Open Your Organization's MCP Integration

Sign in to oper8r and select the organization you want the client to use. Your account must be a member of that organization.
Open the oper8r MCP integration.
Check the organization name above MCP endpoint, then click Copy to copy the full URL. Use the URL shown in the panel; it already includes your organization's slug.
Review Enabled org MCP tools. For the tests below, you need search and answer tools enabled for your role. If the list is empty or a tool is missing, ask your oper8r administrator to check the organization's tool grants and minimum roles.

The hosted endpoint follows this format:

https://oper8r.io/api/mcp/org/YOUR_ORG_SLUG

2. Connect and Authenticate Your Client

Open the MCP server or connector settings in your agent client and add a remote server named oper8r.
Paste the endpoint copied in step 1. If the client asks for a transport, choose HTTP or Streamable HTTP.
Save the connection and complete the OAuth or browser sign-in flow when prompted, using your oper8r account with access to the selected organization. If your deployment requires a token, use the configuration supplied by your administrator.
Refresh the client's tool list and confirm that the oper8r tools shown in Enabled org MCP tools are available.

For clients that accept an mcpServers JSON configuration, click Copy JSON under Client setup snippet in the integration panel. The snippet has this shape:

{
  "mcpServers": {
    "oper8r": {
      "type": "http",
      "url": "https://oper8r.io/api/mcp/org/YOUR_ORG_SLUG"
    }
  }
}

Use your client's configuration format if it differs from this example. See MCP Tools for the search and answer tool reference.

Return to Client skills installer in the oper8r MCP integration, select your client, and follow the matching instructions below. Skills teach your client how to use the tools; installing them does not create the MCP connection or grant access.

ChatGPT or Claude

Select the ChatGPT or Claude tab in the installer and download each skill ZIP.
Open the client's Skills settings and choose the option to create or upload a skill from your computer.
Upload the ZIP files and enable the skills for your session or workspace. Confirm that oper8r-workflows-search-explorer appears in the client's skills list.

Codex

Run this command in your local terminal with Node.js and npm available:

npx @oper8r-io/agent-skills install all --client codex --scope user

Confirm that the installer reports success and creates ~/.codex/skills/oper8r-workflows-search-explorer/SKILL.md, then restart or reload your Codex session.

Cursor

Run this command from your project root with Node.js and npm available:

npx @oper8r-io/agent-skills install all --client cursor --scope project

Confirm that .cursor/rules/oper8r-workflows-search-explorer.mdc exists and is available in Cursor's project rules. Use the MCP connection in that project with the rule active.

Claude Code

Run the commands shown in the Claude Code installer tab. For hosted oper8r:

/plugin marketplace add https://oper8r.io/api/mcp/skills/claude-marketplace
/plugin install oper8r-agent-skills@oper8r-io

Confirm that the plugin is installed, then run /reload-plugins if Claude Code asks you to reload it.

See Agent Skills for other installation options and skill details.

4. Test the Connection with a Search

Start a new conversation with the oper8r connection and skill enabled. Choose a topic you know is present in your organization's knowledge base, then send this prompt with the bracketed text replaced:

Use the oper8r search tool to find up to three sources about [known topic].
Return the source titles and references so I can check them.

Confirm that the client actually calls an oper8r search tool, the call succeeds without an authentication or permission error, and the results include recognizable sources from the selected organization. Open a returned source reference and check that it matches the topic.

An empty result alone does not mean the connection failed. Try the exact title of a document already in oper8r and confirm that you selected the correct organization and that the source is available in its knowledge base.

5. Confirm Cited Answers Work

Use a question that the sources from step 4 can answer:

Use the oper8r answer tool to answer: [question about the known topic].
Include citations and identify any gaps in the available sources.

Confirm that the client calls an oper8r answer tool and returns an answer with citations you can trace to the source material. Review at least one citation to make sure it supports the answer. Your setup is ready when the skill is installed and available, both tool calls succeed, and the returned sources match your organization's knowledge.

If a tool is missing, compare the client's tool list with Enabled org MCP tools and ask your administrator to check access. If authentication fails, reconnect using the copied organization endpoint and the correct oper8r account. If the skill is missing, repeat the installation for that client and reload its session before testing again.

What MCP Can Do

MCP tools can be enabled per organization and role.

Common tool groups:

Search your oper8r knowledge base.
Cited answer generation.
RFP and security answer drafting.
Customer-specific custom tools.

See MCP Tools for the current tool categories.

Agent Skills

MCP tool definitions tell a client what tools exist. Agent skills tell the client how to use those tools well.

Install oper8r skills with:

npx @oper8r-io/agent-skills install all --client all

For skill-specific setup, see Agent Skills.

Grant Model

oper8r tools are not automatically exposed to every user. Admins can grant tools for an organization and set minimum roles. A user only sees the tools that are both enabled for the organization and allowed for their role.

Keep grants scoped to the workflows your team needs. Search and answer tools should still be treated as sensitive because they can retrieve or summarize private organization knowledge.

Example Prompt

Use oper8r to answer this security questionnaire question:
"Do you support SAML SSO, SCIM provisioning, audit logs, and data retention controls?"
Return a concise answer with citations and gaps.