oorbital/DocumentationOpen Oorbital Oorbi MCP documentation
Bring your Oorbi Moves into ChatGPT and Claude. Find the right instruction, use it with your details, and keep what works.
One library. A familiar workflow.
A Move is a reusable instruction, with inputs for what changes each time. Your Moves are also available in Oorbi in Chrome and the Oorbital Console.
Search your own library, shared Moves, company Moves and Oorbital starters.
Provide the missing inputs. Prepare a request or ask your AI to carry it out here.
Review the template and destination before saving. Update eligible Moves you own.
“Find my Move for weekly client updates and get it ready for this week.”
Oorbi finds the saved method. You supply the client and notes. The AI uses the instruction in your conversation.
Get connected
You need an Oorbital account. A Personal account is enough to use your own Moves. Company access depends on your organisation’s permissions and rules.
https://api.oorbital.ai/oorbi/mcpInstall the Oorbi plugin when available to your account. For a custom connection, open Plugins, choose Add custom MCP server and enter the URL above.
Open Customize → Connectors, then Add → Custom → Web. Name the connector Oorbi and enter the URL above.
No API key, custom headers or local server is needed. Oorbi currently uses DCR; choose automatic registration rather than a client metadata document (CIMD). Available controls depend on your AI account and workspace.
Start with something useful
“Do I have a Move for weekly client updates?”
“Use my Weekly client update Move. Ask me for the details you need.”
“Save this prompt as a private Move. Show me the draft first.”
The connector finds and saves Moves. The accompanying Oorbi plugin also includes a skill for improving prompts inside your AI. A server-only connection does not install those skills.
Where supported by your AI, the card lets you enter inputs, preview the request, edit an eligible Move and review a save. Run in this chat sends the prepared request to the conversation; your AI then carries out the task. The card’s acknowledgement means sent, not finished.
Use in another AI prepares text to copy and opens the AI you choose. You decide when to paste and send. Company Moves use the Oorbital handoff to choose an approved AI. Available actions depend on the host, your permissions and the Move’s format.
Understand the data flow
Your AI service and Oorbital are separate services. Connecting Oorbi lets the AI make specific Move requests on your behalf.
| When you… | What is exchanged |
|---|---|
| Check your libraries | Oorbital uses the authorised account to return library details and the default saving destination. |
| Search for a Move | The search words go to Oorbital. Accessible Move summaries come back to the AI. |
| Open a Move | The selected Move’s identifier goes to Oorbital. Its instruction and input definitions return when disclosure is permitted. |
| Fill inputs or run here | The card does not send run answers to Oorbital. Running supplies them to your current AI. The saved template stays separate. |
| Save or update | The reviewed title, summary, reusable instruction and input definitions go to Oorbital, with applicable template metadata. |
| Improve a prompt with the skill | The AI improves it in the conversation. No Oorbi MCP call is needed for this step. |
The MCP connection does not give Oorbital automatic access to your full conversation, local files or browser. Your AI can still send information included in tool arguments. Use task keywords for searches and reusable inputs instead of secrets in saved templates.
Your AI provider processes the conversation under its own terms and settings. The connector does not provide Oorbi in Chrome’s pre-send protection. For storage, retention and your data rights, read the Oorbital Privacy Policy.
For IT and workspace administrators
The connector reads and writes through Oorbital’s existing Move service. Access is checked for the signed-in person and the requested library on each operation.
OAuth grants are tied to the person’s Oorbital account. Read and write scopes are separate. A read-only grant cannot save or update Moves.
Company rules determine whether full Move instructions may be opened in the connected AI. If held back, Oorbi explains the restriction and provides an Oorbital link. Search summaries may still be returned.
The plugin’s save workflow presents the template and destination for approval. Updates check the reviewed revision to prevent overwriting a newer version. Host tool approvals depend on your AI’s settings.
Five tools cover library context, search, opening, saving and updating. They do not expose deletion, company-wide sharing, external message sending or account administration.
Disconnect Oorbi in your AI’s connector settings to stop using that connection. Disconnecting does not delete saved Moves. Manage the library and company sharing in Oorbital. For a deployment or security assessment, contact our team.
Technical reference
| Tool | Access | Purpose |
|---|---|---|
get_oorbi_context | Read | Find the libraries available to the signed-in person and the default saving destination. |
search_moves | Read | Find accessible Moves by name or task. Returns summaries, rather than full instructions. |
get_move | Read | Open a selected Move, subject to the person’s access and company disclosure rules. |
save_move | Write | Save a reviewed reusable template to a library the person can write to. |
update_move | Write | Update an eligible Move the person owns, using the version they reviewed. |
oorbi.readoorbi.writehttps://api.oorbital.ai/.well-known/oauth-protected-resource/oorbi/mcphttps://api.oorbital.ai/.well-known/oauth-authorization-serverThe everyday Oorbi connector uses /oorbi/mcp. Do not substitute the separate governed-work endpoint at /mcp.
Help when you need it
Installation and authorisation are separate. Check that the bundled connector is connected, sign in if requested, enable it for the conversation and start a fresh chat. A local desktop installation may not carry over to another surface.
Check whether the connection has write permission and the account can save to the selected library. Reconnect to review the requested scopes. Your AI workspace may also restrict write actions.
Your membership or company disclosure rules may restrict it. Follow the Oorbital link in the result or ask your workspace administrator. Do not copy company content into the AI to work around a restriction.
Actions depend on the AI host and your access. After server updates, refresh the connection where your host supports it and open the Move in a fresh conversation. Conversational use and Oorbital links provide a fallback.
Check your library in Oorbital before retrying. If the Move changed elsewhere, open the latest version and review your change again.
For setup, access or an organisation review, start a conversation with Oorbital.