---
title: "POST /v1/projects/{projectId}/agent-tools/mcp/validate"
method: POST
path: "/v1/projects/{projectId}/agent-tools/mcp/validate"
tags: ["agent"]
---

# POST /v1/projects/{projectId}/agent-tools/mcp/validate

`POST /v1/projects/{projectId}/agent-tools/mcp/validate`

Probe an external MCP server configured as an agent tool and return its tool names. The outbound call is routed through the SSRF-filtered safeHttp axios; all failure modes collapse to a single generic error so the response cannot be used for port or network reconnaissance.

## Path parameters

- `projectId` string, required

## Request body

- object
  - `type` 'MCP', required
  - `toolName` string, required
  - `serverUrl` string, uri, required
  - `protocol` 'sse' | 'streamable-http' | 'http', required
  - `auth` union, required
    - object
      - `type` 'none', required
    - object
      - `type` 'access_token', required
      - `accessToken` string, required
    - object
      - `type` 'api_key', required
      - `apiKey` string, required
      - `apiKeyHeader` string, required
    - object
      - `type` 'headers', required
      - `headers` object, required

## Response `200`

Default Response

---

[API](https://skmtc.dev/activepieces/apis/activepieces-documentation.md) · [All operations](https://skmtc.dev/activepieces/apis/activepieces-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/activepieces/activepieces-documentation/revisions/745e4b7f764a/schema)