{
  "markdown": "# Orcha MCP server\n\nOrcha 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.\n\nThis repository is the public connection guide and registry listing for Orcha's hosted MCP server. The service runs at:\n\n```\nhttps://app.tryorcha.com/mcp\n```\n\nTransport is Streamable HTTP. The application source code is private; nothing needs to be installed or built from this repository to use the server.\n\n## What the server provides\n\n28 tools spanning:\n\n- Usage guides the agent can read for itself (`get_usage_guide`), covering tool choice, search tuning, citations, writing back, and troubleshooting\n- Ranked search over all indexed workspace content (`search_context`) with fast, balanced, and fresh routing modes, plus a citation on every result\n- File and folder reading, creation, update, organization, and deletion, scoped to what the connection is allowed to touch\n- Curated memories with usage guidance (`list_memories`, `get_memory`), including agent-side curation (`create_memory`, `update_memory`) covering files, folders, synced documents, and database views\n- Structured databases with typed queries (`list_databases`, `query_database`, record CRUD)\n- Direct access to connected read-only sources (`query_source`, `fetch_source_document`, `list_source_documents`)\n- Filesystem-shaped browsing (`browse_context`): ls, tree, find, cat, grep, and stat over a virtual tree of the workspace\n\nEvery connection is isolated to the organization, workspace, permissions, and optional folder scope it was granted.\n\nThe server also serves its usage guides as Agent Skills under the draft\n`io.modelcontextprotocol/skills` extension: `skills/list` enumerates them and\neach file is readable at `skill://orcha/<name>/<path>`. Clients without skills\nsupport get the same content from the `get_usage_guide` tool.\n\n## Connect with OAuth (recommended)\n\nAdd 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.\n\nClaude Code:\n\n```bash\nclaude mcp add --transport http orcha \"https://app.tryorcha.com/mcp\"\n```\n\nclaude.ai and Claude Desktop: Settings, Connectors, Add custom connector, then enter `https://app.tryorcha.com/mcp`.\n\nCodex takes TOML rather than JSON. Add this to `~/.codex/config.toml`, or `.codex/config.toml` in a trusted project:\n\n```toml\n[mcp_servers.orcha]\nurl = \"https://app.tryorcha.com/mcp\"\nauth = \"oauth\"\n```\n\nCodex 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 `get_usage_guide`.\n\nCursor and other OAuth-capable clients: add a remote MCP server with the same URL and follow the sign-in prompt.\n\nClaude Code users can instead install the plugin below, which does the same\nconnection and adds the usage guides as skills.\n\n## Connect with a bearer token (headless and CI clients)\n\n1. Create an Orcha account and workspace at [app.tryorcha.com/signup](https://app.tryorcha.com/signup).\n2. Create an API token scoped to that workspace with only the permissions the client needs. Tokens begin with `orca_`.\n3. Configure the client with an `Authorization` header:\n\n```json\n{\n  \"mcpServers\": {\n    \"orcha\": {\n      \"url\": \"https://app.tryorcha.com/mcp\",\n      \"type\": \"http\",\n      \"headers\": {\n        \"Authorization\": \"Bearer orca_your_token\"\n      }\n    }\n  }\n}\n```\n\n## Example prompts\n\n- \"Search my workspace for the current authentication requirements and summarize them with the source file names.\"\n- \"Show me the five files most related to our deployment runbook.\"\n- \"Check which Orcha memories apply to this task and use the best match as the source of truth.\"\n- \"Create a Markdown file named `launch-checklist.md` from these release requirements.\"\n- \"Get the `engineering-onboarding` memory and identify any conflicting guidance.\"\n\n## Claude Code plugin\n\nClaude Code can install the connection and the usage guides together:\n\n```\n/plugin marketplace add westonhancock/orcha-mcp\n/plugin install orcha@orcha\n```\n\nThe plugin carries its own server configuration, so it replaces the\n`claude mcp add` step above rather than following it. It also installs the four\nusage guides as skills, so Claude loads the relevant one when a task calls for\nit. See [plugins/orcha](./plugins/orcha) for details.\n\nThis is a convenience for one client. Every other client gets the same guidance\nfrom the server through `get_usage_guide`.\n\n## Registry listing\n\nThe server is published in the [Official MCP Registry](https://registry.modelcontextprotocol.io) as `io.github.westonhancock/orcha`. The manifest in [`server.json`](./server.json) mirrors the registry entry. A machine-readable server card is served at `https://app.tryorcha.com/.well-known/mcp/server-card.json`.\n\n## Links\n\n- Product: [tryorcha.com/product](https://tryorcha.com/product)\n- Documentation: [tryorcha.com/docs/reference/mcp](https://tryorcha.com/docs/reference/mcp)\n- Privacy: [tryorcha.com/privacy](https://tryorcha.com/privacy)\n- Terms: [tryorcha.com/terms](https://tryorcha.com/terms)\n- Support: support@tryorcha.com\n",
  "bytes": 5478,
  "sha": "6d2c280e7a70ce00b756ec626307f0b759d144c1dd039719ef450a633c5beb19",
  "repo_slug": "westonhancock/orcha-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_westonhancock_orcha_3d5a105d/readme"
}