Skip to main content

OpenAPI 3.x

If you don’t want to read the documentation online, you can download the OpenAPI 3 definition files directly. All API operations are also enabled as tools within MCP.

Postman Collections v2

Postman Collections are also available for download.

MCP Server Configuration

You can use the AWS OpenAPI MCP Server to enable all Guile API operations as tools in your MCP-compatible AI assistant. Add this configuration to your MCP settings file:
{
  "mcpServers": {
    "guile-docs": {
      "url": "https://docs.guile.app/mcp"
    },
    "guile-authentication": {
      "command": "uvx",
      "args": [
        "awslabs.openapi-mcp-server@latest"
      ],
      "env": {
        "API_NAME": "Authentication",
        "API_BASE_URL": "https://api.guile.app",
        "API_SPEC_URL": "https://docs.guile.app/api-reference/Authentication/openapi.yaml"
      }
    },
    "guile-appointments": {
      "command": "uvx",
      "args": [
        "awslabs.openapi-mcp-server@latest"
      ],
      "env": {
        "API_NAME": "Appointments",
        "API_BASE_URL": "https://api.guile.app",
        "API_SPEC_URL": "https://docs.guile.app/api-reference/Appointments/openapi.yaml"
      }
    },
    "guile-barbers": {
      "command": "uvx",
      "args": [
        "awslabs.openapi-mcp-server@latest"
      ],
      "env": {
        "API_NAME": "Barbers",
        "API_BASE_URL": "https://api.guile.app",
        "API_SPEC_URL": "https://docs.guile.app/api-reference/Barbers/openapi.yaml"
      }
    },
    "guile-businesses": {
      "command": "uvx",
      "args": [
        "awslabs.openapi-mcp-server@latest"
      ],
      "env": {
        "API_NAME": "Businesses",
        "API_BASE_URL": "https://api.guile.app",
        "API_SPEC_URL": "https://docs.guile.app/api-reference/Businesses/openapi.yaml"
      }
    },
    "guile-clients": {
      "command": "uvx",
      "args": [
        "awslabs.openapi-mcp-server@latest"
      ],
      "env": {
        "API_NAME": "Clients",
        "API_BASE_URL": "https://api.guile.app",
        "API_SPEC_URL": "https://docs.guile.app/api-reference/Clients/openapi.yaml"
      }
    },
    "guile-customers": {
      "command": "uvx",
      "args": [
        "awslabs.openapi-mcp-server@latest"
      ],
      "env": {
        "API_NAME": "Customers",
        "API_BASE_URL": "https://api.guile.app",
        "API_SPEC_URL": "https://docs.guile.app/api-reference/Customers/openapi.yaml"
      }
    },
    "guile-fees": {
      "command": "uvx",
      "args": [
        "awslabs.openapi-mcp-server@latest"
      ],
      "env": {
        "API_NAME": "Fees",
        "API_BASE_URL": "https://api.guile.app",
        "API_SPEC_URL": "https://docs.guile.app/api-reference/Fees/openapi.yaml"
      }
    },
    "guile-integrations": {
      "command": "uvx",
      "args": [
        "awslabs.openapi-mcp-server@latest"
      ],
      "env": {
        "API_NAME": "Integrations",
        "API_BASE_URL": "https://api.guile.app",
        "API_SPEC_URL": "https://docs.guile.app/api-reference/Integrations/openapi.yaml"
      }
    },
    "guile-invitations": {
      "command": "uvx",
      "args": [
        "awslabs.openapi-mcp-server@latest"
      ],
      "env": {
        "API_NAME": "Invitations",
        "API_BASE_URL": "https://api.guile.app",
        "API_SPEC_URL": "https://docs.guile.app/api-reference/Invitations/openapi.yaml"
      }
    },
    "guile-payouts": {
      "command": "uvx",
      "args": [
        "awslabs.openapi-mcp-server@latest"
      ],
      "env": {
        "API_NAME": "Payouts",
        "API_BASE_URL": "https://api.guile.app",
        "API_SPEC_URL": "https://docs.guile.app/api-reference/Payouts/openapi.yaml"
      }
    },
    "guile-photos": {
      "command": "uvx",
      "args": [
        "awslabs.openapi-mcp-server@latest"
      ],
      "env": {
        "API_NAME": "Photos",
        "API_BASE_URL": "https://api.guile.app",
        "API_SPEC_URL": "https://docs.guile.app/api-reference/Photos/openapi.yaml"
      }
    },
    "guile-services": {
      "command": "uvx",
      "args": [
        "awslabs.openapi-mcp-server@latest"
      ],
      "env": {
        "API_NAME": "Services",
        "API_BASE_URL": "https://api.guile.app",
        "API_SPEC_URL": "https://docs.guile.app/api-reference/Services/openapi.yaml"
      }
    }
  }
}
This configuration creates separate MCP servers for each API domain, making all operations available as tools in Claude Desktop, Cline, or other MCP-compatible clients.