Server URL
Connect your AI tool to the hosted Metal MCP server:Access is scoped to your Metal user and organization, and respects the same permissions you have in the app.
Prerequisites
1
Ask an admin to enable MCP
An organization admin must turn on the MCP server first: in the Metal app, go to Settings → Organization → API & MCP Access and enable Allow access to the Metal MCP server.
2
Use an MCP-compatible tool
You need a client that supports remote MCP servers, such as Cursor, Claude, or ChatGPT. See other clients for everything else.
Connect your tool
Cursor
Add Metal as a remote MCP server in Cursor.
Claude
Add Metal as a connector in Claude.
ChatGPT
Add Metal as a connector in ChatGPT.
Portability and interoperability
Metal exposes your firm’s context through standards-based interfaces, so your data is not locked into one chat surface or one model provider.- Open agent protocol: MCP is an open standard. Any MCP-compatible tool can connect to
https://mcp.metal.ai/mcp, including tools such as Cursor, Claude, ChatGPT, and clients that bridge local-only MCP support withmcp-remote. - Programmatic API access: the Metal REST API returns JSON for the same core records your team works with in the app, including companies, deals, people, documents, activities, lists, enrichments, scores, financial metrics, workflows, and data observations. Use the API to sync records in, read enriched context out, and feed downstream systems. See the API reference.
- Customer-controlled identifiers: companies, deals, and people can carry your own
externalIdandexternalReferencevalues, which makes it easier to reconcile Metal records with your CRM, data warehouse, or other systems. See the data model. - Permission-aware access: MCP uses OAuth and API requests use organization-scoped API keys, so connected tools only see data they are allowed to access.
Available tools
Once connected, your AI client discovers 44 tools for searching and reading your firm’s data, running workflows, and (with the right permissions) authoring workflows. Tools return JSON in a text content block — see the tools reference for parameters, response shapes, and examples.
The server also exposes resources (field definitions, document types) and prompts (guided research workflows). Details are in the tools reference.
The exact tools available to you depend on your OAuth scopes, organization settings, and app permissions.
Troubleshooting
The connection fails or asks me to sign in repeatedly
The connection fails or asks me to sign in repeatedly
Confirm an admin has enabled Allow access to the Metal MCP server under Settings → Organization → API & MCP Access. Then clear your tool’s saved Metal connection and reconnect so it can complete a fresh OAuth sign-in.
I connected to the wrong organization
I connected to the wrong organization
Disconnect and reconnect. During sign-in, Metal prompts you to choose an organization when your account belongs to more than one.
My tool only supports local (stdio) MCP servers
My tool only supports local (stdio) MCP servers
Use a bridge like
mcp-remote. See other MCP clients.
