{"openapi":"3.1.0","info":{"title":"Vultr Catalog (BYOK) API","version":"0.1.0","description":"Vultr Catalog (BYOK) lets an AI assistant read your own Vultr Catalog data through the Vultr Catalog API with a key you supply (API key (restrict it to your own address or leave access control open)). Read-only: 8 tools (list_plans, list_metal_plans, list_regions, list_region_availability, list_operating_systems, list_applications, list_marketplace_app_variables, list_public_isos). The BYOK key...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-vultr-catalog.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-vultr-catalog/docs"},"termsOfService":"https://connectorbay.com/byok-vultr-catalog/terms"},"servers":[{"url":"https://byok-vultr-catalog.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-vultr-catalog/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_plans":{"post":{"operationId":"list_plans","summary":"List Vultr cloud compute plans with vCPUs, memory (MB), disk (GB), bandwidth (GB), monthly price, plan type, GPU details","description":"List Vultr cloud compute plans with vCPUs, memory (MB), disk (GB), bandwidth (GB), monthly price, plan type, GPU details and the regions offering each. Use for \"Which Vultr plans have at least 4 GB of RAM and what do they cost\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"type":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Only plans of this type, for example all, vc2, vhf, vdc, voc or vcg; leave empty for every type.","title":"Type"},"per_page":{"anyOf":[{"maximum":500,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"How many results to return (1 to 500).","title":"Per Page"},"cursor":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Paging cursor copied from meta.links.next of the previous answer; leave empty for the first page.","title":"Cursor"}},"title":"list_plansArguments","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_metal_plans":{"post":{"operationId":"list_metal_plans","summary":"List Vultr bare metal plans with CPU model, cores, threads, memory (MB), disks, bandwidth, monthly price and the regions","description":"List Vultr bare metal plans with CPU model, cores, threads, memory (MB), disks, bandwidth, monthly price and the regions offering each. Use for \"What bare metal plans does Vultr offer\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"per_page":{"anyOf":[{"maximum":500,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"How many results to return (1 to 500).","title":"Per Page"},"cursor":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Paging cursor copied from meta.links.next of the previous answer; leave empty for the first page.","title":"Cursor"}},"title":"list_metal_plansArguments","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_regions":{"post":{"operationId":"list_regions","summary":"List Vultr regions with id, city, country, continent, supported options and connectivity. Use for \"Which Vultr regions a","description":"List Vultr regions with id, city, country, continent, supported options and connectivity. Use for \"Which Vultr regions are in Europe\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"per_page":{"anyOf":[{"maximum":500,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"How many results to return (1 to 500).","title":"Per Page"},"cursor":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Paging cursor copied from meta.links.next of the previous answer; leave empty for the first page.","title":"Cursor"}},"title":"list_regionsArguments","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_region_availability":{"post":{"operationId":"list_region_availability","summary":"List the plan ids currently available to deploy in one Vultr region. Use for \"Which Vultr plans can I deploy in New Jers","description":"List the plan ids currently available to deploy in one Vultr region. Use for \"Which Vultr plans can I deploy in New Jersey right now\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region_id":{"description":"Region id such as 'ewr', as returned by list_regions.","maxLength":16,"title":"Region Id","type":"string"},"type":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Only plans of this type, for example vc2, vhf, vdc, voc or vbm; leave empty for all.","title":"Type"}},"required":["region_id"],"title":"list_region_availabilityArguments","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_operating_systems":{"post":{"operationId":"list_operating_systems","summary":"List the operating system images Vultr can deploy with numeric id, name, architecture and family. Use for \"Which operati","description":"List the operating system images Vultr can deploy with numeric id, name, architecture and family. Use for \"Which operating systems can I install on Vultr\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"per_page":{"anyOf":[{"maximum":500,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"How many results to return (1 to 500).","title":"Per Page"},"cursor":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Paging cursor copied from meta.links.next of the previous answer; leave empty for the first page.","title":"Cursor"}},"title":"list_operating_systemsArguments","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_applications":{"post":{"operationId":"list_applications","summary":"List the one-click applications Vultr can deploy with id, name, short name, deploy name, type, vendor and image id. Use ","description":"List the one-click applications Vultr can deploy with id, name, short name, deploy name, type, vendor and image id. Use for \"Which one-click apps does Vultr offer\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"per_page":{"anyOf":[{"maximum":500,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"How many results to return (1 to 500).","title":"Per Page"},"cursor":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Paging cursor copied from meta.links.next of the previous answer; leave empty for the first page.","title":"Cursor"}},"title":"list_applicationsArguments","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_marketplace_app_variables":{"post":{"operationId":"list_marketplace_app_variables","summary":"List the user-supplied variables a Marketplace application asks for at deploy time: name, description and whether it is ","description":"List the user-supplied variables a Marketplace application asks for at deploy time: name, description and whether it is required. Use for \"What settings does a Vultr marketplace app need when I deploy it\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"image_id":{"description":"Marketplace application image id, as shown in image_id by list_applications.","maxLength":100,"title":"Image Id","type":"string"}},"required":["image_id"],"title":"list_marketplace_app_variablesArguments","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_public_isos":{"post":{"operationId":"list_public_isos","summary":"List the public ISO images Vultr hosts with id, name, description and checksum. Use for \"Which public ISOs can I mount o","description":"List the public ISO images Vultr hosts with id, name, description and checksum. Use for \"Which public ISOs can I mount on a Vultr server\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"per_page":{"anyOf":[{"maximum":500,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"How many results to return (1 to 500).","title":"Per Page"},"cursor":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Paging cursor copied from meta.links.next of the previous answer; leave empty for the first page.","title":"Cursor"}},"title":"list_public_isosArguments","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}}}}