{"openapi":"3.1.0","info":{"title":"Glama (BYOK) API","version":"0.1.0","description":"Glama (BYOK) lets an AI assistant read your own Glama data through the Glama API with a key you supply (Glama API key). Read-only: 7 tools (list_mcp_servers, get_mcp_server, list_remote_connectors, get_remote_connector, list_server_attributes, list_connector_attributes, list_hosted_instances). The BYOK key travels with each request, is used for that one call only and is never stored, logged or...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-glama.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-glama/docs"},"termsOfService":"https://connectorbay.com/byok-glama/terms"},"servers":[{"url":"https://byok-glama.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-glama/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/list_mcp_servers":{"post":{"operationId":"list_mcp_servers","summary":"List or search MCP servers in the Glama directory with description, quality score, license and repository, newest first ","description":"List or search MCP servers in the Glama directory with description, quality score, license and repository, newest first or by relevance. Use for \"Find MCP servers about Hacker News in the Glama directory\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Free-text search, for example 'hacker news'.","title":"Query"},"first":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many results to return (1 to 100, default 10).","title":"First"},"after":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Cursor from pageInfo.endCursor of the previous answer; leave empty for the first page.","title":"After"},"sort":{"anyOf":[{"enum":["search-relevance:desc","added-at:desc"],"type":"string"},{"type":"null"}],"default":"added-at:desc","description":"Order: added-at:desc (default, newest first) or search-relevance:desc. Keep it unchanged while following a cursor.","title":"Sort"}},"title":"list_mcp_serversArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_mcp_server":{"post":{"operationId":"get_mcp_server","summary":"Get one MCP server listing by namespace and slug: description, quality score, license, repository, attributes and Glama ","description":"Get one MCP server listing by namespace and slug: description, quality score, license, repository, attributes and Glama page URL. Use for \"Show the Glama listing for microsoft/playwright-mcp\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"namespace":{"description":"Namespace (owner) of the listing, for example 'microsoft'.","maxLength":200,"title":"Namespace","type":"string"},"slug":{"description":"Listing slug, for example 'playwright-mcp'.","maxLength":200,"title":"Slug","type":"string"}},"required":["namespace","slug"],"title":"get_mcp_serverArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_remote_connectors":{"post":{"operationId":"list_remote_connectors","summary":"List or search remote MCP connectors (hosted MCP endpoints) with auth type, endpoint URL, health, tool count and quality","description":"List or search remote MCP connectors (hosted MCP endpoints) with auth type, endpoint URL, health, tool count and quality score. Use for \"Which remote MCP connectors on Glama need no authentication\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Free-text search, for example 'sentry'.","title":"Query"},"attributes":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated attribute keys a connector must all carry, for example 'auth:none,capability:tools'; see list_connector_attributes.","title":"Attributes"},"first":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many results to return (1 to 100, default 10).","title":"First"},"after":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Cursor from pageInfo.endCursor of the previous answer; leave empty for the first page.","title":"After"},"sort":{"anyOf":[{"enum":["featured:desc","recommended:desc","github-stargazers:desc","name:asc","search-relevance:desc","updated-at:desc"],"type":"string"},{"type":"null"}],"default":"recommended:desc","description":"Order: recommended:desc (default), featured:desc, github-stargazers:desc, name:asc, search-relevance:desc or updated-at:desc.","title":"Sort"}},"title":"list_remote_connectorsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_remote_connector":{"post":{"operationId":"get_remote_connector","summary":"Get one remote MCP connector by namespace and slug with auth type, endpoint URL, health and tool count. Use for \"How do ","description":"Get one remote MCP connector by namespace and slug with auth type, endpoint URL, health and tool count. Use for \"How do I connect to the Sentry MCP connector listed on Glama\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"namespace":{"description":"Namespace of the connector, for example 'sentry'.","maxLength":200,"title":"Namespace","type":"string"},"slug":{"description":"Connector slug, for example 'sentry'.","maxLength":200,"title":"Slug","type":"string"}},"required":["namespace","slug"],"title":"get_remote_connectorArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_server_attributes":{"post":{"operationId":"list_server_attributes","summary":"List the attribute keys that MCP server listings can carry, with name and description. Use for \"Which attributes can Gla","description":"List the attribute keys that MCP server listings can carry, with name and description. Use for \"Which attributes can Glama MCP servers have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_server_attributesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_connector_attributes":{"post":{"operationId":"list_connector_attributes","summary":"List the attribute keys usable to filter remote MCP connectors (for example auth:none), with name and description. Use f","description":"List the attribute keys usable to filter remote MCP connectors (for example auth:none), with name and description. Use for \"What filter attributes exist for remote MCP connectors on Glama\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_connector_attributesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_hosted_instances":{"post":{"operationId":"list_hosted_instances","summary":"List MCP server instances hosted by Glama for your account with instance id, MCP endpoint and server name. Use for \"Whic","description":"List MCP server instances hosted by Glama for your account with instance id, MCP endpoint and server name. Use for \"Which MCP servers do I have hosted on Glama\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_hosted_instancesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}