Guide
MCP
You can access your Contexts and Workflows through the Oi MCP (Model Context Protocol) server. This is the hosted surface for Oi. It gives MCP-capable clients a secure way to access the reusable setup your team stores in Oi.
If you are not familiar with this concept, it is a way to connect what you have setup within Oi; your contexts, workflows and so on - to any of your AI clients; Cursor, Claude, ChatGPT etc. that support MCP.
Core details
- Server URL
https://api.oioioi.ai/mcp- Transport
- Streamable HTTP over the hosted Oi endpoint.
- Auth
- OAuth or bearer token using an exported Oi organization API key.
Available Tools
These are the main MCP tools Oi exposes and what each one does. Some are tools you will use directly, and some support the experience behind the scenes.
MCP Tool: oi_use_context
Use Context
The main tool for doing real work with Oi. Use it when you want Oi to help with a task, either with a named Context or by routing the task for you.
oi designer review this onboarding flowoi route this launch plan through the right Contextsoi product-manager turn this feature idea into a ticketoi designer+growth-lead review this pricing page and suggest improvementsoi designer@2 review these designs against the updated style guideMCP Tool: oi_list_contexts
List Contexts
Shows the Contexts your team can use. This is a good starting point when you want to see what is available before choosing one.
oi list contextsMCP Tool: oi_get_context
Get Context
Returns the compiled Context itself. This is more useful when a client or workflow needs the reusable context directly instead of asking Oi to handle a task for you.
oi get context designerMCP Tool: oi_start_prompt_session
Start Prompt Session
Keeps one Context active for the rest of the thread so follow-up requests stay in that mode.
oi software-engineer in this thread for follow-up implementation workMCP Tool: oi_recommend
Recommend
Suggests the most suitable Context or Workflow for a task when you want guidance before choosing one.
oi recommend the best setup for reviewing this pricing pageMCP Tool: oi_list_workflows
List Workflows
Shows the Workflows available to your team. Start here when you want an ordered sequence of Contexts rather than one Context.
oi list workflowsMCP Tool: oi_get_workflow
Get Workflow
Returns the details of a specific Workflow so a client or user can inspect the steps, Contexts, and handoffs before using it.
oi get workflow launch-reviewMCP Tool: oi_start_workflow_session
Start Workflow Session
Keeps a Workflow active in the current thread so follow-up requests can stay inside that sequence.
oi start workflow launch-review for this threadMCP Tool: oi_use_workflow
Use Workflow
Runs a Workflow for a concrete task, moving through the ordered Contexts and handoff notes.
oi workflow launch-review turn this roadmap note into a launch planMCP Tool: oi_save_feedback_to_draft
Save Feedback To Draft
Saves confirmed feedback into a private Context draft so the context can improve over time.
oi save this correction to the active designer draft for future runsMCP Tool: oi_confirm_guardrail
Confirm Guardrail
Handles guardrail confirmation when Oi needs an explicit user approval step before continuing.
oi confirm the guardrail and continueMCP Tool: oi_report_context_usage
Report Context Usage
Reports usage metadata back to Oi after a client uses a Context.
oi report that the designer Context completed successfully