> ## Documentation Index > Fetch the complete documentation index at: https://docs.roark.ai/llms.txt > Use this file to discover all available pages before exploring further. # Refresh an MCP server > Connects to the server again and records the tools it offers now. Agents keep calling the tools they were given; a new tool reaches an agent only once you add it. ## OpenAPI ````yaml /api-reference/openapi.documented.json post /v1/integrations/mcp-server/{serverId}/refresh openapi: 3.1.0 info: title: Roark Analytics API description: >- The Roark Analytics API gives you access to the same API that powers the award winning Roark Analytics platform. version: 1.0.0 servers: - description: Production url: https://api.roark.ai security: - Bearer: [] tags: - name: Agent - name: Customer - name: Agent Endpoint - name: Tool - name: Phone Number - name: Call - name: Chat - name: Metric - name: Metric Policy - name: Metric Collection Job - name: Customer Flow - name: Customer Flow Edge Case - name: Simulation - name: Simulation Persona - name: Simulation Environment - name: Simulation Scenario - name: Simulation Run Plan - name: Simulation Template - name: Simulation Audio Clip - name: Simulation Run Plan Job - name: Simulation Job - name: HTTP Request Definition - name: Webhook - name: Issue - name: Autoimprove - name: Agent Config - name: Knowledge Base - name: Calendar Integration - name: MCP Server Integration - name: Config - name: Organization Project - name: Organization Project Member - name: Organization Project API Key - name: Organization Config - name: CLI Auth - name: Me - name: Project - name: Usage - name: Analytics - name: Dashboard - name: Live Report - name: Benchmark - name: Health - name: Campaign Credit paths: /v1/integrations/mcp-server/{serverId}/refresh: post: tags: - MCP Server Integration summary: Refresh an MCP server description: >- Connects to the server again and records the tools it offers now. Agents keep calling the tools they were given; a new tool reaches an agent only once you add it. operationId: postV1IntegrationsMcp-serverByServerIdRefresh parameters: - in: path name: serverId schema: type: string format: uuid required: true responses: '200': description: The server content: application/json: schema: $ref: '#/components/schemas/McpServerSingleResponse' '400': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Validation error example: type: validation code: invalid_parameter message: The request was invalid param: email description: Bad Request '401': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Authentication error example: type: authentication code: unauthorized message: Authentication required description: Unauthorized '404': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Not found error example: type: not_found code: resource_not_found message: The requested resource could not be found description: Not Found '500': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Server error example: type: internal code: internal_error message: Internal server error description: Internal Server Error components: schemas: McpServerSingleResponse: type: object properties: data: $ref: '#/components/schemas/McpServerResponse' required: - data ErrorResponse: type: object properties: type: type: string enum: - validation - authentication - forbidden - not_found - conflict - payment_required - rate_limit - internal description: The error type category examples: - validation - authentication code: type: string description: Machine-readable error code identifier examples: - invalid_parameter - missing_required_field - unauthorized message: type: string description: Human-readable error message examples: - The request was invalid - Authentication required param: type: string description: The parameter that caused the error (if applicable) examples: - email - user_id details: description: Additional error context information required: - type - code - message McpServerResponse: type: object properties: id: type: string format: uuid description: The id a tool names the server by label: type: string example: CRM url: type: string example: https://mcp.example.com/mcp transport: type: string enum: - STREAMABLE_HTTP - SSE authType: type: string enum: - NONE - BEARER - HEADER description: How the server authenticates. The credential is never returned. authHeaderName: type: - string - 'null' description: The header a HEADER credential is sent in directoryKey: type: - string - 'null' description: The MCP registry entry it was connected from serverName: type: - string - 'null' description: The name the server gives itself serverVersion: type: - string - 'null' instructions: type: - string - 'null' description: >- The server's own advice on using it, for you to read. Never shown to the agent. tools: type: array items: $ref: '#/components/schemas/McpServerTool' catalogHash: type: string description: Changes when the server changes the tools it offers boundTools: type: array items: $ref: '#/components/schemas/McpServerBoundTool' description: The tools calling on this server, and whether it still offers each lastDiscoveredAt: type: string createdAt: type: string updatedAt: type: string required: - id - label - url - transport - authType - authHeaderName - directoryKey - serverName - serverVersion - instructions - tools - catalogHash - boundTools - lastDiscoveredAt - createdAt - updatedAt McpServerTool: type: object properties: name: type: string description: The tool as the server names it example: search_customers description: type: - string - 'null' suggestedName: type: - string - 'null' description: >- What a tool for it is called by default: the name with unusable characters replaced readOnly: type: - boolean - 'null' description: The server's hint that the tool only reads unavailableReason: type: - string - 'null' description: >- Why an agent could not use this tool, such as a name a built-in tool already has required: - name - description - suggestedName - readOnly - unavailableReason McpServerBoundTool: type: object properties: toolDefinitionId: type: string format: uuid name: type: string remoteToolName: type: string description: The tool it calls, as the server names it offered: type: boolean description: 'False when the server stopped offering it: agents lose the tool' required: - toolDefinitionId - name - remoteToolName - offered securitySchemes: Bearer: type: http scheme: bearer bearerFormat: JWT ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.