> ## Documentation Index > Fetch the complete documentation index at: https://docs.cognigy.com/llms.txt > Use this file to discover all available pages before exploring further. # List the tools an MCP server offers, labelled against what this project imported > Connects to the registered MCP server and returns the tools it currently offers. Each tool is labeled `new`, `imported`, `changed` or `missing` against the tools this project has imported from the server. A `new` entry also carries `newSinceReview`, which is `true` only when the tool is absent from the catalog recorded at the last sync, that is, when the server added it since you last looked. A `new` entry with `newSinceReview: false` is a tool you already saw and chose not to import, so it isn't a problem indicator. Nothing is cached or stored, so every call is a live read, and a fixed server or a rotated credential is reflected immediately. Before anything is imported, every entry is `new`, which is what the create flow needs. ## OpenAPI ````yaml https://api-trial.cognigy.ai/swagger/openapi.json get /mcp-servers/{id}/tools openapi: 3.0.3 info: contact: email: support@example.com name: API Support description: API for managing agents and related resources license: name: Apache 2.0 url: http://www.apache.org/licenses/LICENSE-2.0.html termsOfService: http://swagger.io/terms/ title: Agents API version: '1.0' servers: - url: https://api-trial.cognigy.ai/v1 security: - ApiKey: [] tags: - name: Agents - name: Brand personas - name: Tools - name: Built-in tools - name: Skills - name: Built-in skills - name: MCP servers - name: Tool references paths: /mcp-servers/{id}/tools: get: tags: - MCP servers summary: >- List the tools an MCP server offers, labelled against what this project imported description: >- Connects to the registered MCP server and returns the tools it currently offers. Each tool is labeled `new`, `imported`, `changed` or `missing` against the tools this project has imported from the server. A `new` entry also carries `newSinceReview`, which is `true` only when the tool is absent from the catalog recorded at the last sync, that is, when the server added it since you last looked. A `new` entry with `newSinceReview: false` is a tool you already saw and chose not to import, so it isn't a problem indicator. Nothing is cached or stored, so every call is a live read, and a fixed server or a rotated credential is reflected immediately. Before anything is imported, every entry is `new`, which is what the create flow needs. parameters: - description: The unique identifier for the mcp server. in: path name: id required: true schema: type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/internal_mcpservers.DiscoverToolsResponse' description: OK '400': content: application/json: schema: $ref: >- #/components/schemas/github_com_cognigy_ai-agents-v2_internal_middleware.ProblemDetailBadRequest description: >- Invalid ID format, or the MCP server refused the request (HTTP 401 or 403). This is a configuration error the caller must fix, and it deliberately isn't a 502, so no layer retries it '403': content: application/json: schema: $ref: >- #/components/schemas/github_com_cognigy_ai-agents-v2_internal_middleware.ProblemDetailForbidden description: Access denied '404': content: application/json: schema: $ref: >- #/components/schemas/github_com_cognigy_ai-agents-v2_internal_middleware.ProblemDetailNotFound description: MCP server not found '500': content: application/json: schema: $ref: >- #/components/schemas/github_com_cognigy_ai-agents-v2_internal_middleware.ProblemDetailInternalError description: Internal server error '502': content: application/json: schema: $ref: >- #/components/schemas/github_com_cognigy_ai-agents-v2_internal_middleware.ProblemDetailBadGateway description: The MCP server could not be reached or returned an unusable response components: schemas: internal_mcpservers.DiscoverToolsResponse: properties: items: items: $ref: '#/components/schemas/internal_mcpservers.RemoteToolResponse' type: array total: example: 2 type: integer type: object github_com_cognigy_ai-agents-v2_internal_middleware.ProblemDetailBadRequest: properties: detail: example: request body validation failed type: string errors: items: $ref: >- #/components/schemas/github_com_cognigy_ai-agents-v2_internal_middleware.FieldError type: array instance: example: /v1/{resource} type: string status: example: 400 type: integer title: example: Bad Request type: string traceId: example: api--a4d2f126-bec4-4544-a049-7c0cf08524ed type: string type: example: about:blank type: string type: object github_com_cognigy_ai-agents-v2_internal_middleware.ProblemDetailForbidden: properties: detail: example: 'access denied: insufficient permissions' type: string instance: example: /v1/{resource}/{id} type: string status: example: 403 type: integer title: example: Forbidden type: string traceId: example: api--a4d2f126-bec4-4544-a049-7c0cf08524ed type: string type: example: about:blank type: string type: object github_com_cognigy_ai-agents-v2_internal_middleware.ProblemDetailNotFound: properties: detail: example: the requested resource does not exist type: string instance: example: /v1/{resource}/{id} type: string status: example: 404 type: integer title: example: Not Found type: string traceId: example: api--a4d2f126-bec4-4544-a049-7c0cf08524ed type: string type: example: about:blank type: string type: object github_com_cognigy_ai-agents-v2_internal_middleware.ProblemDetailInternalError: properties: detail: example: internal server error type: string instance: example: /v1/{resource} type: string status: example: 500 type: integer title: example: Internal Server Error type: string traceId: example: api--a4d2f126-bec4-4544-a049-7c0cf08524ed type: string type: example: about:blank type: string type: object github_com_cognigy_ai-agents-v2_internal_middleware.ProblemDetailBadGateway: properties: detail: example: the MCP server did not respond type: string instance: example: /v1/{resource}/{id} type: string status: example: 502 type: integer title: example: Bad Gateway type: string traceId: example: api--a4d2f126-bec4-4544-a049-7c0cf08524ed type: string type: example: about:blank type: string type: object internal_mcpservers.RemoteToolResponse: properties: description: type: string inputSchema: additionalProperties: {} description: >- InputSchema is the remote tool's JSON Schema, passed through verbatim. type: object name: example: search_issues type: string newSinceReview: description: >- NewSinceReview marks a tool this server offers that the customer has never been shown — set only when Status is "new" and the tool is absent from the catalogue recorded at the last sync. A tool with status "new" and newSinceReview false is one the customer saw and chose not to import, which is a healthy steady state and must not be presented as a problem. example: false type: boolean status: description: >- Status labels this tool against the rows this project has imported from THIS server: new (not imported), imported (imported and identical), changed (the server's description or schema has drifted from what is stored), missing (imported but no longer offered). enum: - new - imported - changed - missing example: new type: string toolId: description: >- ToolId and ToolReferenceId identify the imported row, present for every status except "new". ToolReferenceId is what a sync `remove` names and what agents link by; ToolId is what a client links to. example: 507f1f77bcf86cd799439011 type: string toolReferenceId: example: 550e8400-e29b-41d4-a716-446655440000 type: string type: object github_com_cognigy_ai-agents-v2_internal_middleware.FieldError: properties: field: type: string message: type: string type: object securitySchemes: ApiKey: description: '[Production] API key for production authentication' in: header name: X-API-Key type: apiKey ````