MCP tools

When an AI tool connects to your world, Orbismo exposes a set of MCP tools the agent can call. You don’t invoke these by name — you describe what you want in plain language and the agent picks the right ones. This page is a reference for what’s available.

Which tools an agent sees depends on its access:

Read-only connections see only the reading and search tools.
Read-write connections (an editor or owner, or a read-write API key) also see the authoring tools.
The world-switching tools appear only on the connector, not on a single-world connection.

Switching worlds (connector only)

Tool	What it does
`list_my_worlds`	Lists the worlds you can access through this connection.
`set_active_world`	Activates one of those worlds for the session.

Reading and searching (read-only)

Tool	What it does
`get_world_context`	Returns the world’s schema — its entity types and relationship types.
`search_entities`	Finds entities by name or criteria.
`get_entities`	Fetches specific entities with their properties, tags, and lore.
`search_lore`	Meaning-based (semantic) search across the world’s lore.
`get_timeline`	Returns events in chronological order.

Authoring content (read-write)

Tool	What it does
`create_entities`	Creates one or more entities.
`update_entity`	Edits an entity’s properties and tags.
`delete_entity`	Removes an entity.
`manage_entity_lore`	Adds or edits the lore attached to an entity.
`add_enumeration_term`	Adds a term to the world’s controlled tag vocabulary.

Relationships (read-write)

Tool	What it does
`create_relationships`	Links entities with typed relationships.
`update_relationship`	Edits a relationship.
`delete_relationship`	Removes a relationship.

If an agent says a tool isn’t available, its connection probably doesn’t have the right permission, or — on the connector — no world is active yet. See Troubleshooting.