Coolify MCP Server

Instructions

Implementation Reference

• src/index.ts:1262-1270 (handler)

  Handler function for the 'get_team' tool. Extracts team_id from arguments, validates it, makes GET request to Coolify API endpoint `/teams/${teamId}`, and returns the team details as formatted JSON text content.

  case 'get_team':
    const teamId = request.params.arguments?.team_id;
    if (!teamId) {
      throw new McpError(ErrorCode.InvalidParams, 'team_id is required');
    }
    const teamResponse = await this.axiosInstance.get(`/teams/${teamId}`);
    return {
      content: [{ type: 'text', text: JSON.stringify(teamResponse.data, null, 2) }]
    };

• src/index.ts:161-186 (registration)

  Registration of the 'get_team' tool in the ListTools response, including name, description, and detailed inputSchema with team_id parameter definition, examples, and usage workflow.

  {
    name: 'get_team',
    description: 'Get details of a specific team. Requires a team ID obtained from list_teams.',
    inputSchema: {
      type: 'object',
      properties: {
        team_id: {
          type: 'string',
          description: 'ID of the team to retrieve. This is typically a numeric ID obtained from the list_teams response.',
          examples: ['0', '1', '42']
        }
      },
      required: ['team_id'],
      examples: [
        {
          team_id: 'sg4gsws44wksg040o4ok80ww'
        }
      ],
      additionalInfo: {
        workflow: [
          '1. First call list_teams to get available team UUIDs',
          '2. Use a team UUID from the response in this operation'
        ]
      }
    }
  },

• src/index.ts:164-184 (schema)

  Input schema definition for 'get_team' tool, specifying required 'team_id' string parameter with description, examples, and workflow notes.

  inputSchema: {
    type: 'object',
    properties: {
      team_id: {
        type: 'string',
        description: 'ID of the team to retrieve. This is typically a numeric ID obtained from the list_teams response.',
        examples: ['0', '1', '42']
      }
    },
    required: ['team_id'],
    examples: [
      {
        team_id: 'sg4gsws44wksg040o4ok80ww'
      }
    ],
    additionalInfo: {
      workflow: [
        '1. First call list_teams to get available team UUIDs',
        '2. Use a team UUID from the response in this operation'
      ]
    }