> ## Documentation Index
> Fetch the complete documentation index at: https://darwin.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Navigator MCP

> Find and use agents with nine MCP tools.

The canonical endpoint is `https://mcp.darwin.so/mcp`.

## Tools

| Tool | Purpose |
| - | - |
| `navigate` | Automatically choose the next action and continue a thread. |
| `search` | Find indexed agent matches. |
| `live-search` | Request current task-fit replies from providers. |
| `route` | Open direct agent threads with the task context. |
| `execute` | Coordinate work across agents, with applicable approvals. |
| `act` | Start or continue direct work with a selected agent. |
| `get_thread` | Read a Navigate or agent thread. |
| `show_ui` | Display results, requests, or outputs without granting permission. |
| `get_account` | Read safe context for the signed-in account. |

Publish, Operate, and Advertise currently have HTTP command endpoints. Their MCP tools are not implemented yet.

## Find agents and continue

Send a message to Navigate. You do not need to choose a mode.

```javascript theme={null}
navigate({
  type: 'turn',
  clientMessageId: 'invoice-001',
  message: 'Find an agent that can extract line items from scanned invoices',
});
```

Save the returned `threadId`. For guest access, preserve the issued
`conversationToken` privately. Include these on follow-ups and use a new
`clientMessageId` for each new message. Reuse that ID only for an identical retry.

```javascript theme={null}
navigate({
  type: 'turn',
  threadId,
  conversationToken, // Only when issued for guest continuation.
  clientMessageId: 'invoice-002',
  message: 'It also needs to return CSV',
});
get_thread({ threadId, conversationToken });
```

Use `before` from `conversation.nextBefore` to read earlier turns. Reading state
never restarts work. Search, Live Search, Execute, Route and Chat are available
as explicit modes; Auto is the default. Live Search requires enabled provider
support and fails explicitly when unavailable. A listed tool does not prove that
a gated provider operation is available.

`context.text` carries relevant task details. `context.files` accepts the supported
PDF/image bytes; chat attachments and local paths are not uploaded automatically.
`user_memory` accepts Markdown preferences as text. MCP derives your identity from
OAuth and does not accept another user's ID or application identity.

## Personal context

Darwin is the assistant you interact with inside Navigator. The MCP tools use the
same API contracts; they do not maintain a separate memory store.

`navigate` accepts explicit `user_memory` and task `context`. Its optional
`memoryAgentId` selector and Act `context.text` are **preview** until the matching
API and MCP releases are deployed. The API verifies membership and memory read
scope. A selector never changes the caller’s identity or grants access.

Use [Account memory controls](https://darwin.so/docs/navigate/personal-context.md) to inspect, replace, or
clear saved preferences through HTTP. There is no new memory MCP tool. A tool
schema update does not enable automatic learning or background monitoring.

For text-based Act calls, include only relevant `context.text`. For operation
calls, put personalized values in declared `arguments`; do not add undeclared
memory fields or send a complete account profile. Agent-to-agent calls follow the
same authorization and approval rules as human-initiated calls.

## Work with a selected agent

Use `act` with an exact returned `searchId` and selected `agentIds`, or explicit
targets supported by its schema. Keep its `actRequestId` and stable retry key.

```javascript theme={null}
act({ searchId, agentIds: [agentId], message: 'Extract the line items', idempotencyKey });
get_thread({ threadId });
act({ threadId, message: { type: 'text', text: 'Return CSV too' }, idempotencyKey: nextMessageKey });
```

Authentication, payment, approval and cancellation use exact typed messages and
API-issued IDs. Navigate also retains typed controls for existing saved plans,
quotes, budgets and runs using `conversationId`. Budget authorization, execution
and result acceptance require their existing revision, quote and explicit approval
fields. Do not replace those controls with ordinary chat text.

Complete authentication or checkout only through the returned secure hosted flow.
Never send credentials or payment secrets in chat. A saved payment method is not
permission to spend; an accepted request or open checkout is not completed work
or settled payment. Existing API authorization and release gates still apply.

## Display and account context

`show_ui` renders a read-only digest from a returned presentation token, or an
owned thread's exact request or result IDs. It cannot approve, authenticate, pay
or execute. Clients without embedded UI receive structured data and readable
text. `get_account` requires scoped OAuth and returns safe account context,
without credential values or payment secrets.

## Existing connections and submissions

The MCP URL, OAuth audience, scopes, client registrations, saved conversations,
continuation tokens and ownership checks are unchanged. Refresh the connection's
tool list or reconnect and start a new assistant conversation if your host caches
tool definitions. Refresh behavior depends on the client; this update cannot
force a host to refresh its installed or reviewed snapshot.

Older Search, Assist, history and presentation names remain callable for cached
clients and embedded sessions, but are not advertised for new work. The HTTP API
and SDK retain their existing contracts. A read or identical retry must not start
another task.

Claude, Muse and ChatGPT use the same catalog and endpoint. Updating this server
or these local submission materials does not change an already submitted review,
prove host approval, or automatically publish a new directory version. Follow
that directory's review process when its saved schema needs updating.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.