oper8r Docs

MCP Tools

Customer-facing implementation guide

Back to overview

oper8r MCP tools are grouped by the kind of work they support. Tool access is organization-granted and role-aware, so the exact tool list depends on your deployment and admin settings.

Workflow Tools

Workflow tools synthesize grounded context from connected sources.

ToolUse
oper8r_get_account_contextAccount briefs for meeting prep, renewal, expansion, multithread audits, and GTM context.
oper8r_find_precedentPrior deal, objection, RFP, security, negotiation, or internal examples with citations.
oper8r_diagnose_riskForecast, slip, churn, expansion, and account risk diagnosis.
oper8r_generate_messageCited outbound, follow-up, renewal, expansion, security follow-up, or GTM message drafts.
oper8r_answer_rfp_security_questionEvidence-backed RFP and security answers with confidence and review guidance.

Example:

Find prior security questionnaire answers about SSO, SCIM,
data retention, and subprocessors. Return reusable language
with citations and gaps.

Search And Graph Exploration

These tools retrieve and inspect oper8r knowledge without mutating it.

ToolUse
oper8r_searchSearch across approved oper8r knowledge available to the authenticated user.
oper8r_graph_exploreExplore entities and relationships from a text query or entity anchor.
oper8r_graph_getEntityFetch one entity by exact graph entity ID or deterministic external ID.
oper8r_graph_getEdgesFetch graph edges for one resolved entity.

Use exact external IDs when possible. For example, prefer a Salesforce Account ID, HubSpot company ID, Slack user ID, or known email over a fuzzy name search.

Integration Health

oper8r_integrations_status reports lightweight integration status without exposing credentials, tokens, connection IDs, or raw provider metadata.

Use it when an agent needs to know whether a source appears connected before asking the user for data that may not be available.

Employee Graph Curation

Employee graph curation tools write to the organization-internal shared employee graph only.

ToolUse
oper8r_employee_graph_upsert_entitiesAdd or update source-backed shared internal graph entities and external IDs.
oper8r_employee_graph_upsert_factsAdd source-backed shared internal facts with temporal metadata when needed.
oper8r_employee_graph_find_factsFind facts by IDs, supersession key, exact triple, or search text.
oper8r_employee_graph_find_reconciliation_candidatesDiscover duplicate, conflicting, temporal, and semantic fact candidates.
oper8r_employee_graph_preview_reconciliationPreview reconciliation decisions without writing.
oper8r_employee_graph_apply_reconciliationApply explicit human-approved reconciliation decisions.
oper8r_employee_graph_invalidate_factInvalidate stale facts and backing edges when appropriate.
oper8r_employee_graph_merge_entitiesMerge verified duplicate entities.

Every response should include a scope contract equivalent to:

{
  "graph": "employee",
  "accessScope": "employee",
  "privateGraphAllowed": false,
  "customerGraphAllowed": false
}

Do not use these tools for private user memory, customer-facing public graph data, secrets, passwords, API keys, unsupported summaries, or guesses.

API Parity

Most org-granted MCP tools can also be exposed as API endpoints:

POST https://YOUR_OPER8R_HOST/api/tools/org/YOUR_ORG_SLUG/TOOL_KEY

See APIs for request examples.

Talk to oper8r

Bring us the workflow, integration, or deployment constraint. We can build it with you, run it for you, or advise your team.