Orcha MCP server

Orcha MCP server

Orcha is a unified context layer for AI tools and agents. It stores, indexes, and exposes organizational, team, or individual knowledge. Files, structured databases, and connected sources live in one workspace, and agents reach them through Model Context Protocol (MCP), CLI with virtual file system, or REST API, with permissions, citations, and provenance.

This repository is the public connection guide and registry listing for Orcha's hosted MCP server. The service runs at:

https://app.tryorcha.com/mcp

Transport is Streamable HTTP. The application source code is private; nothing needs to be installed or built from this repository to use the server.

What the server provides

28 tools spanning:

• Usage guides the agent can read for itself (getusageguide), covering tool choice, search tuning, citations, writing back, and troubleshooting
• Ranked search over all indexed workspace content (search_context) with fast, balanced, and fresh routing modes, plus a citation on every result
• File and folder reading, creation, update, organization, and deletion, scoped to what the connection is allowed to touch
• Curated memories with usage guidance (listmemories, getmemory), including agent-side curation (creatememory, updatememory) covering files, folders, synced documents, and database views
• Structured databases with typed queries (listdatabases, querydatabase, record CRUD)
• Direct access to connected read-only sources (querysource, fetchsourcedocument, listsource_documents)
• Filesystem-shaped browsing (browse_context): ls, tree, find, cat, grep, and stat over a virtual tree of the workspace

Every connection is isolated to the organization, workspace, permissions, and optional folder scope it was granted.

The server also serves its usage guides as Agent Skills under the draft io.modelcontextprotocol/skills extension: skills/list enumerates them and each file is readable at skill://orcha//. Clients without skills support get the same content from the getusageguide tool.

Connect with OAuth (recommended)

Add the server URL to any OAuth-capable MCP client. The client discovers Orcha's authorization server automatically and walks you through consent; the grant is scoped to the organization and workspace you approve.

Claude Code:

claude mcp add --transport http orcha "https://app.tryorcha.com/mcp"

claude.ai and Claude Desktop: Settings, Connectors, Add custom connector, then enter https://app.tryorcha.com/mcp.

Codex takes TOML rather than JSON. Add this to ~/.codex/config.toml, or .codex/config.toml in a trusted project:

[mcp_servers.orcha]
url = "https://app.tryorcha.com/mcp"
auth = "oauth"

Codex also reads Agent Skills from .agents/skills/ in a repository or ~/.agents/skills/ globally, so Orcha's four usage guides can be installed there. They are available with no installation through getusageguide.

Cursor and other OAuth-capable clients: add a remote MCP server with the same URL and follow the sign-in prompt.

Claude Code users can instead install the plugin below, which does the same connection and adds the usage guides as skills.

Connect with a bearer token (headless and CI clients)

1. Create an Orcha account and workspace at app.tryorcha.com/signup.
2. Create an API token scoped to that workspace with only the permissions the client needs. Tokens begin with orca_.
3. Configure the client with an Authorization header:

{
  "mcpServers": {
    "orcha": {
      "url": "https://app.tryorcha.com/mcp",
      "type": "http",
      "headers": {
        "Authorization": "Bearer orca_your_token"
      }
    }
  }
}

Example prompts

Shortened. The full README is on GitHub.