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
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.
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.
Available tools
Once connected, your AI tool can use these Metal tools:| Tool | Description |
|---|---|
search_companies | Search companies by name, sector, location, or description. |
get_company | Get a detailed company profile by ID. |
search_documents | Semantic and keyword search across documents. |
search_people | Search contacts by name, title, company, or email. |
get_person | Get a detailed contact profile by ID. |
search_deals | Search deals by name, company, or description. |
get_deal | Get a detailed deal by ID. |
list_lists | List the resource lists in your organization. |
get_list | Get a list with its column schema and entries. |
get_activities | Get activities for a company. |
get_activity | Get a single activity by ID. |
list_workflows | Discover workflows you can inspect or run. |
get_workflow | Get a workflow’s schema and accepted inputs. |
get_workflow_step | Get a single workflow step definition. |
list_workflow_runs | List workflow runs, with optional filters. |
get_workflow_run | Get a run’s status, outputs, and citations. |
get_workflow_run_step | Get a run step’s evidence, tool calls, artifacts, and errors. |
run_workflow | Start a run of a published workflow. |
review_workflow_hitl_step | Approve or reject a workflow human-in-the-loop step. |
The exact tools available to you depend on your organization’s settings and your 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.