Perplexity
Perplexity connects to remote MCP servers through custom connectors, available on Pro and Enterprise plans (an admin must enable custom connectors for the organization on Enterprise). Orbismo works with either of Perplexity’s supported auth choices, so you can use the connector or a single-world API key.
Before you start
Section titled “Before you start”You’ll need one of:
- To use the connector: nothing extra, you’ll sign in during setup.
- To use an API key: your world’s ID (the UUID in the portal URL,
https://app.orbismo.com/worlds/{world_id}/...) and a key from Generate an API key. Use a read-only key for your first connection.
The connector (recommended)
Section titled “The connector (recommended)”- In Perplexity, open Account settings → Connectors.
- Click + Custom connector and choose Remote.
- Fill in the form:
- Name:
Orbismo - MCP Server URL:
https://app.orbismo.com/api/v1/mcp - Authentication:
OAuth - Transport:
Streamable HTTP
- Name:
- Acknowledge the risk notice and click Add.
- On the Connectors screen, click the new Orbismo card to start the sign-in flow. Sign in and choose which worlds this connection may access.
See The connector for how choosing a world and managing access works.
A single world with an API key
Section titled “A single world with an API key”- Follow steps 1-2 above.
- Fill in the form:
- Name:
Orbismo - MCP Server URL:
https://app.orbismo.com/api/v1/worlds/<world_id>/mcp - Authentication:
API Key, then paste youroc_live_<your_key>value - Transport:
Streamable HTTP
- Name:
- Acknowledge the risk notice and click Add, then enable the connector from the Connectors screen.
This pins Perplexity to that one world. Use a separate connector and key per world.
Verify
Section titled “Verify”On the Connectors screen, confirm the Orbismo card shows as Connected with its tools listed. On a single-world URL, a missing tool usually means your access level doesn’t include it. On the connector the tool list is the same for every world. On a read-write connection, write tools stay listed even on worlds where you are a viewer, and the change is refused when the agent tries it. See Troubleshooting.
Use it in a chat
Section titled “Use it in a chat”Enable the Orbismo connector for a thread from the composer’s tools menu, then name it in your prompt so Perplexity reaches for the right tools. On the connector, start by picking a world:
Use Orbismo to list my worlds, then work in "Family History".On a single-world connection there is nothing to list, so just ask for what you want:
Use Orbismo to show me the people added most recently.What it can do follows your role on whichever world it is working in (or the key’s permission, for an API-key connection).
Reference
Section titled “Reference”Perplexity’s own help center covers the custom connector UI in more depth, and is the best source if a step above has moved: