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.

Server URL

Use the organization-scoped MCP URL when configuring a client:

https://YOUR_OPER8R_HOST/api/mcp/org/YOUR_ORG_SLUG

For hosted oper8r, this is usually:

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

Client Configuration

Generic MCP client configuration:

{
  "mcpServers": {
    "oper8r": {
      "url": "https://YOUR_OPER8R_HOST/api/mcp/org/YOUR_ORG_SLUG"
    }
  }
}

Some clients will prompt for OAuth or browser-based login. Others may require an approved token or connector configuration depending on deployment.

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.

Setup Checklist

1. Confirm the organization slug.
2. Enable the desired MCP tools for the organization.
3. Confirm role requirements.
4. Configure the MCP client URL.
5. Authenticate the client.
6. Install the matching oper8r agent skills.
7. Test with a small, source-backed request.

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.