Skip to content

MCP Server

BETA

The Findable MCP server lets MCP-compatible agents answer questions and perform analysis against the buildings, documents, tasks, SharePoint sync state, and red flag data you already have access to in Findable.

Server URL

Use the production URL when connecting an external agent:

Findable MCP servertext
https://mcp.findable.ai

Development and staging environments use https://mcp.findable.dev.

Connect an Agent

  1. Open the integrations, connectors, or MCP settings in your AI agent.
  2. Add a custom connector and paste the Findable MCP server URL.
  3. Sign in to Findable when prompted.
  4. Authorize the agent to access your Findable account.

You never enter a client ID or secret. Findable registers each agent automatically when it first connects (OAuth Dynamic Client Registration), and each person signs in with their own Findable account. Step-by-step guides: Claude, ChatGPT, Microsoft Copilot Studio.

Claude (web and desktop)

Claude adds Findable as a custom connector. Connectors belong to your Claude account, so one added on claude.ai is also available in the Claude desktop app.

Free, Pro and Max plans

  1. In Claude, open Customize > Connectors.
  2. Select + Add, then Add custom connector.
  3. Name it Findable, enter https://mcp.findable.ai and select Continue.
  4. Keep the detected sign-in settings. If Claude asks how it should identify itself, choose Register automatically. Leave request headers empty.
  5. Select Add, then Connect. Sign in to Findable and choose Allow.

The Claude Free plan allows one custom connector.

Team and Enterprise plans

An owner adds Findable once for the whole Claude organisation, then each member connects their own Findable account.

  1. The owner opens Organization settings > Connectors, selects Add, then Custom > Web.
  2. The owner enters the name Findable and the URL https://mcp.findable.ai, keeps the detected sign-in settings, and selects Add.
  3. Each member opens Customize > Connectors, finds Findable, selects Connect, signs in to Findable and chooses Allow.

On Team plans only owners and primary owners can add connectors. On Enterprise, people with a custom role that manages connectors can add them too.

Use Findable in a Claude chat

Select + at the lower left of the message box, open Connectors and switch Findable on. Then ask about your buildings, for example “Summarise the fire safety documentation for Storgata 12.” Claude shows document, building and red flag results as interactive widgets.

ChatGPT

ChatGPT adds Findable as a custom MCP server on chatgpt.com. Custom MCP servers are set up on the web, not in the mobile apps.

  1. On chatgpt.com, open Plugins.
  2. Select +, then Add custom MCP server.
  3. Name it Findable. Under Connection, enter https://mcp.findable.ai.
  4. Choose OAuth for authentication. ChatGPT discovers Findable’s sign-in and registers itself, so leave any client ID and secret fields empty.
  5. Review the risk warning, tick I understand and want to continue and select Create as a plugin.
  6. Sign in to Findable when prompted and choose Allow.
  7. In a new conversation, type @ and pick Findable.

ChatGPT asks you to confirm before it runs a tool that is not read-only. Findable’s write tools only prepare a proposal that you review in Findable.

Microsoft Copilot Studio

Copilot Studio connects through its native MCP connector, which handles the OAuth sign-in for you.

  1. In Copilot Studio, open your agent and go to Tools > Add a tool > Model Context Protocol.
  2. Choose the option that discovers the server from its URL (labelled Dynamic discovery in current builds) and paste https://mcp.findable.ai.
  3. Create the connection. A Findable sign-in window opens — sign in and choose Allow. Let the window finish redirecting back to Copilot Studio on its own; closing it early leaves the connection incomplete.
  4. Add the connected tools to your agent and publish.

Each user connects with their own Findable account and sees only what that account can access. Single sign-on is not required. Copilot Studio limits how much a tool may return, so Findable’s search and folder tools reply with compact result lists — the agent then calls get_document to attach the one file you picked.

Access and Security

The MCP server uses OAuth 2.1 with PKCE. Access is tied to your Findable user account, and every tool call is checked against the same permissions as the Findable app.

  • Agents only see buildings and documents your user can access.
  • Access is in public beta. Any Findable user with read access to at least one organisation, portfolio, building, project or collection can connect.
  • You can revoke connected agents from Findable settings.
  • Most tools are read-only. Where enabled, task and routine changes produce a Findable review link and execute only after you approve them in Findable. Red flag regeneration is a separate write tool.

In the Findable app, go to Settings > Connect Claude & ChatGPT (called AI agents in earlier versions) to copy the server URL, view connected agents, or revoke access.

Available Tools

The server exposes 30 Findable-specific tools for resource discovery, document search, Q&A, task lookup, SharePoint status, and red flag reporting.

Account and navigation

whoamifind_resourcesget_customerget_buildingget_portfolioget_projectget_collection

Lists and discovery

list_buildingslist_portfolioslist_projectslist_project_documentslist_collectionslist_userslist_integrations

Tasks

list_tasksquery_work_itemsprepare_work_item_actionWRITEget_task

Documents and Q&A

search_documentslist_folder_childrenget_documentget_document_metadataask_assistant

SharePoint

list_sharepoint_documentsget_sharepoint_sync_statuslist_sharepoint_subscriptions

Red flag

get_red_flaglist_red_flag_itemsget_red_flag_itemprepare_red_flag_generationWRITE

ask_assistant was previously called ask_findable. The old name stays callable, so saved agent instructions keep working.

Compatible hosts

Findable works with standards-compliant remote MCP clients, including Claude web, Desktop and Code, ChatGPT connectors, and Microsoft Copilot Studio's native MCP connector. Interactive result widgets appear only in hosts that support MCP Apps; all other hosts receive the same data as text.

Interactive Results

In hosts that support MCP Apps — such as Claude — many tools return an interactive widget alongside their text answer instead of a plain list. In hosts without widget support, the same tools return clean text and the agent behaves exactly as before.

  • Document search renders as a grid; selecting a result opens the actual document, not just a thumbnail.
  • Buildings and portfolios render as cards you can drill into for detail, then search their documents or ask a scoped question.
  • Red flag reports render as compliance cards you can drill from theme to finding to the evidence documents behind each finding.
  • Widgets follow your Findable language preference and match the host's light or dark theme.

Agents should resolve names before fetching detail. Start with whoami to inspect access, use find_resources to resolve customers, buildings, portfolios, projects, or collections, then call the specific getter, list, search, or Q&A tool needed for the task.