Use Sim Search from another app to search and read your organization's sources through their live APIs, or ask the Sim Assistant for cited answers. Your current Sim membership, provider access, and source restrictions apply.
Connect an app
- Confirm you can find a document in the organization's Search. Connect your source account first if required.
- Open Settings → Search MCP in the organization view. Select your App and copy the displayed URL, command, or configuration.
- Follow the steps for your app below, sign in to Sim, and approve Search access. Each teammate signs in separately; no API key is needed for this flow.
| App | Finish setup |
|---|---|
| Claude | Add the copied Server URL as a custom connector, then connect it. For Team or Enterprise, an owner first adds it under Organization settings → Connectors; members then connect individually. See Claude's custom connector instructions. |
| Codex | Run the copied Terminal command and complete browser sign-in. If authentication is needed again, run codex mcp login sim-search. |
| Claude Code | Run the copied Terminal command, then open /mcp in Claude Code and authenticate. See Claude Code's MCP instructions. |
| Cursor | Add the copied sim-search entry to mcpServers in ~/.cursor/mcp.json, preserving your other entries. Enable the server in Cursor and sign in to Sim. See Cursor's MCP instructions. |
| Other | Add the Server URL to a client that supports remote MCP with OAuth. Choose Streamable HTTP if asked. |
For Claude's hosted custom connectors, your Sim deployment must be reachable from Claude's servers; a localhost URL will not work. See Claude's network requirements.
Use the tools
Ask your app: “Use Sim Search to find our launch checklist, read the relevant document, and cite the source.” The app can use three tools:
| Tool | Behavior |
|---|---|
search | Searches the live providers. Use source, date filters, or documentIds to narrow results. nativeQueries supports provider syntax and pagination. Inspect live.accounts for provider status and cursors, and live.guidance for syntax. |
read_document | Reads fresh content using the exact opaque documentId returned by Search. When hasMore is true, pass the returned next.startChunkIndex and next.startOffset into the next read. It does not accept an arbitrary URL. |
chat | Asks the Sim Assistant a question using accessible sources and returns an answer with citations. Each call creates a new private Sim conversation. It accepts shared source and date filters; provider-native queries belong to search. |
Cite the returned citationUrl when one is available. Keep documentId unchanged: it binds the result to your account, source, and organization. A title or a provider's raw document ID is not a substitute.
The tools do not edit source content. Assistant policy and usage limits apply to chat.
Access and limits
The connection applies to the organization whose URL you copied. Sim checks current membership, source settings, and provider access on search and read. Connecting MCP does not add sources, connect provider accounts, or grant extra permissions. Live results do not depend on a Sim content or permission sync.
search returns up to 20 results by default, with topK from 1 to 50. Its query allows up to 2,000 characters. A query may be empty when a date bound is supplied. Provider limits and filtering can return fewer results. Use a provider's returned continuation cursor with the same query and account; an empty page does not establish complete coverage.
read_document accepts limit from 1 to 8 (default 3). The live backend returns bounded text pages and may return fewer chunks. Follow its next object rather than calculating offsets yourself. Live document IDs may be up to 4,000 characters. There is no pending-index metadata state.
chat accepts questions up to 8,192 characters. Tool responses are limited to 1 MiB. API rate limits apply; follow any retry delay. Provider failures or incomplete retrieval are reported explicitly, and the tools do not fall back to an old index when a live provider is unavailable.
These are the Search MCP schemas. Refresh tool discovery in clients that previously connected to the retired indexed backend.
Reconnect or revoke access
If sign-in expires or access is revoked, reconnect in your app. To withdraw its Sim authorization, open Settings → General → Authorized apps, find the app, and revoke it. This stops future requests; it does not remove content already returned to that app.
If Search MCP is unavailable, ask an organization admin to check the organization's Search availability and MCP policy. If results are missing, check the same query in Sim Search, your provider connection, and the current source settings first.
Workspace MCP is separate
Organization Search MCP searches organization sources. Workspace MCP tools connect external servers to Sim agents; MCP deployment exposes workflows as tools. Neither setup automatically adds workspace content to organization Search.