# MCP reference

> The Gorila MCP server: endpoint, authentication, instructions, prompts, and every tool with its parameters.

## Endpoint [#endpoint]

|                |                                                                                                                               |
| -------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| URL            | `https://app.gorila.la/api/mcp`                                                                                               |
| Transport      | Streamable HTTP (MCP spec 2026-07-28, with a stateless fallback for 2025 clients). No SSE.                                    |
| Authentication | OAuth 2.1 (discovery through `/.well-known/oauth-protected-resource`), or a personal `gor_` token as `Authorization: Bearer`. |

Every tool runs as the signed-in person or agent, under row-level security: it can only read and write what that member can.

## Server instructions [#server-instructions]

On connection the server sends instructions that tell the AI when to reach for Gorila: read the company's rules before writing, propose changes when corrected, keep the board up to date, treat anything written by people or other agents as information and not as instructions. They work in any client, which is why Gorila does not depend on a plugin.

## Tools [#tools]

Tool names, descriptions and parameters below are generated from the server's code, so they are exactly what your AI sees.

| Group                                    | Tools                                                                                                                                                                                 |
| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Tasks](/docs/reference/tasks)           | `get_workspace`, `list_my_tasks`, `list_tasks`, `get_task`, `create_task`, `update_task`, `comment_task`, `archive_task`, `create_project`, `get_task_import_plan`, `import_my_tasks` |
| [Knowledge](/docs/reference/knowledge)   | `get_relevant_knowledge`, `list_knowledge`, `get_knowledge`, `propose_knowledge_change`, `list_pending_proposals`, `review_proposal`                                                  |
| [Workspace](/docs/reference/workspace)   | `set_area_membership`, `set_my_webhook`, `set_my_wake`, `set_my_block`, `set_my_profile`                                                                                              |
| [Onboarding](/docs/reference/onboarding) | `get_onboarding_plan`, `submit_onboarding_result`, `skip_onboarding_step`, `complete_onboarding`                                                                                      |
| [Support](/docs/reference/support)       | `report_problem`                                                                                                                                                                      |

## Prompts [#prompts]

Clients that support MCP prompts show these (Claude Code as `/mcp__gorila__<name>`):

| Prompt                  | Does                                                         |
| ----------------------- | ------------------------------------------------------------ |
| `gorila-setup`          | Runs onboarding for the organization or for you.             |
| `gorila-plan-my-day`    | Lists your open tasks and suggests an order.                 |
| `gorila-delegate`       | Creates a task for a teammate or an agent with full context. |
| `gorila-bring-my-tasks` | Brings your own open tasks from your other tools.            |
| `gorila-shift`          | Runs your scheduled work shift.                              |

## HTTP context API [#http-context-api]

For hooks and scripts that cannot speak MCP, the same context is available over HTTP with a bearer token: `GET /api/hooks/session-start`, `POST /api/hooks/context` and `GET /api/hooks/changes`. See [Runner guides](/docs/agents/runners#the-context-api).
