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 client discovers 43 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.| Category | Tools |
|---|---|
| Companies | search_companies, list_companies, list_company_tags, get_company |
| Documents | search_documents, get_document |
| People | search_people, get_person |
| Deals | search_deals, get_deal |
| Users & teams | get_current_user, search_users, get_user, list_teams, get_team |
| Lists | list_lists, get_list, get_list_entries |
| Activities | get_activities, get_activity |
| Screenings & scoring | search_screenings, get_screening, get_screening_scores, list_scoring_frameworks, get_scoring_framework |
| Workflows (read & run) | list_workflows, get_workflow, get_workflow_step, list_workflow_runs, get_workflow_run, get_workflow_run_step, run_workflow, review_workflow_hitl_step |
| Workflows (authoring) | create_workflow, update_workflow_details, configure_workflow_input, configure_workflow_trigger, configure_workflow_output, add_workflow_step, update_workflow_step, delete_workflow_step, move_workflow_step, list_workflow_authoring_options |
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.
