{"openapi":"3.1.0","info":{"title":"Few Servers directory API","version":"1.0.0","description":"Read-only JSON API of the Few Servers directory: 33,027 MCP servers read from the official MCP Registry on 2026-10-10 and 41 server providers read from their own pages. Every fact keeps its source and read date. Being listed is not a safety check; there are no ratings or rankings by Few Servers. Free for now, 60 requests a minute per address, no key. Paths end with a slash; the form without it answers with a 308 redirect.","contact":{"name":"Few Servers","url":"https://www.fewservers.com/developers/","email":"hello@fewservers.com"}},"servers":[{"url":"https://www.fewservers.com"}],"externalDocs":{"description":"Docs and MCP server setup","url":"https://www.fewservers.com/developers/"},"paths":{"/api/v1/mcp/search/":{"get":{"operationId":"searchMcpServers","summary":"Search MCP servers","parameters":[{"name":"q","in":"query","required":false,"description":"Words to find in the name, title or description.","schema":{"type":"string"}},{"name":"category","in":"query","required":false,"description":"Category id.","schema":{"type":"string","enum":["databases","cloud-devops","monitoring","dev-tools","browser-web","ai-memory","productivity","communication","finance-crypto","data-analytics","security","marketing-sales","commerce","media-design","files-storage","location-gov","health-education","other"]}},{"name":"transport","in":"query","required":false,"description":"remote or local.","schema":{"type":"string","enum":["remote","local"]}},{"name":"official","in":"query","required":false,"description":"true = vendor's own namespace only.","schema":{"type":"boolean"}},{"name":"tested","in":"query","required":false,"description":"true = installed and run by Few Servers only.","schema":{"type":"boolean"}},{"name":"limit","in":"query","required":false,"description":"1 to 25, default 10.","schema":{"type":"integer","minimum":1,"maximum":25,"default":10}},{"name":"offset","in":"query","required":false,"description":"Rows to skip, 0 to 5000.","schema":{"type":"integer","minimum":0,"maximum":5000,"default":0}}],"responses":{"200":{"description":"Matching servers.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/McpSearch"}}}},"400":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/api/v1/mcp/servers/{id}/":{"get":{"operationId":"getMcpServer","summary":"One MCP server","parameters":[{"name":"id","in":"path","required":true,"description":"Slug (io-github-upstash-context7) or registry name (io.github.upstash/context7; the slash may be sent as it is).","schema":{"type":"string"}}],"responses":{"200":{"description":"The full record.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/McpServer"}}}},"400":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/api/v1/mcp/servers/{id}/install/":{"get":{"operationId":"getMcpServerInstall","summary":"Install details as published in the registry record","parameters":[{"name":"id","in":"path","required":true,"description":"Slug (io-github-upstash-context7) or registry name (io.github.upstash/context7; the slash may be sent as it is).","schema":{"type":"string"}}],"responses":{"200":{"description":"Install details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/McpInstall"}}}},"400":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/api/v1/mcp/servers/{id}/alternatives/":{"get":{"operationId":"getMcpServerAlternatives","summary":"Other servers in the same category, by a stated sort rule","parameters":[{"name":"id","in":"path","required":true,"description":"Slug (io-github-upstash-context7) or registry name (io.github.upstash/context7; the slash may be sent as it is).","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"1 to 25, default 10.","schema":{"type":"integer","minimum":1,"maximum":25,"default":10}}],"responses":{"200":{"description":"Servers in the same category.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/McpAlternatives"}}}},"400":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/api/v1/providers/search/":{"get":{"operationId":"searchProviders","summary":"Search server providers","parameters":[{"name":"type","in":"query","required":false,"description":"Product type.","schema":{"type":"string","enum":["cloud-vps","dedicated","bare-metal","gpu","colocation","hardware-vendor","managed-hosting","edge-cdn"]}},{"name":"country","in":"query","required":false,"description":"Country name or ISO alpha-2 code with a data centre we read.","schema":{"type":"string"}},{"name":"max_price","in":"query","required":false,"description":"Highest lowest-listed monthly price, as listed in USD or EUR, not converted.","schema":{"type":"number","minimum":0}},{"name":"q","in":"query","required":false,"description":"Part of the company name.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"1 to 50, default 25.","schema":{"type":"integer","minimum":1,"maximum":50,"default":25}}],"responses":{"200":{"description":"Matching providers, alphabetical.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderSearch"}}}},"400":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/api/v1/providers/{slug}/":{"get":{"operationId":"getProvider","summary":"One server provider","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The full profile.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Provider"}}}},"400":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/RateLimited"}}}}},"components":{"responses":{"Error":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"RateLimited":{"description":"More than 60 requests in a minute from this address.","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]},"McpRow":{"type":"object","description":"Compact MCP server row.","additionalProperties":true,"properties":{"name":{"type":"string"},"slug":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"category":{"type":"string"},"transport":{"type":"array","items":{"type":"string","enum":["remote","local"]}},"package_types":{"type":"array","items":{"type":"string"}},"official":{"type":"boolean"},"tested":{"type":"boolean"},"github_stars":{"type":["integer","null"]},"has_page":{"type":"boolean"},"listing_url":{"type":"string"},"api_url":{"type":"string"},"registry_updated":{"type":["string","null"]},"last_seen":{"type":"string"}}},"McpSearch":{"type":"object","description":"Search result.","additionalProperties":true,"properties":{"query":{"type":"string"},"filters":{"type":"object"},"total":{"type":"integer"},"offset":{"type":"integer"},"count":{"type":"integer"},"results":{"type":"array","items":{"$ref":"#/components/schemas/McpRow"}},"order":{"type":"string"},"source":{"type":"string"},"read_date":{"type":"string"},"github_stars_read_date":{"type":["string","null"]},"note":{"type":"string"}}},"McpServer":{"type":"object","description":"Full record of one server. Fields we do not hold are null.","additionalProperties":true,"properties":{"name":{"type":"string"},"slug":{"type":"string"},"title":{"type":"string"},"description":{"type":["string","null"]},"description_source":{"type":"string"},"category":{"type":"object"},"transport":{"type":"array","items":{"type":"string"}},"version":{"type":["string","null"]},"official":{"type":"boolean"},"ours":{"type":"boolean"},"github_stars":{"type":["object","null"]},"tested":{"type":["object","null"]},"repository":{"type":["string","null"]},"website":{"type":["string","null"]},"registry_record":{"type":["string","null"]},"install":{"type":"object"},"has_page":{"type":"boolean"},"listing_url":{"type":"string"},"source":{"type":"string"},"read_date":{"type":"string"},"last_seen":{"type":"string"}}},"McpInstall":{"type":"object","description":"Install details.","additionalProperties":true,"properties":{"name":{"type":"string"},"slug":{"type":"string"},"install":{"type":"object"},"tested":{"type":["object","null"]},"listing_url":{"type":"string"},"source":{"type":"string"},"read_date":{"type":"string"}}},"McpAlternatives":{"type":"object","description":"Servers in the same category.","additionalProperties":true,"properties":{"for":{"type":"object"},"category":{"type":"object"},"total_in_category":{"type":"integer"},"count":{"type":"integer"},"results":{"type":"array","items":{"$ref":"#/components/schemas/McpRow"}},"ranking_rule":{"type":"string"},"source":{"type":"string"},"read_date":{"type":"string"}}},"ProviderSearch":{"type":"object","description":"Provider search result.","additionalProperties":true,"properties":{"filters":{"type":"object"},"total":{"type":"integer"},"count":{"type":"integer"},"results":{"type":"array","items":{"type":"object"}},"order":{"type":"string"},"price_note":{"type":"string"},"source":{"type":"string"},"read_date":{"type":"string"}}},"Provider":{"type":"object","description":"Provider profile. Each entry of facts is null or {value, source_url, read_date, quote}.","additionalProperties":true,"properties":{"slug":{"type":"string"},"name":{"type":"string"},"url":{"type":"string"},"listing_url":{"type":"string"},"types_list":{"type":"array","items":{"type":"string"}},"countries":{"type":"array","items":{"type":"object"}},"lowest_monthly_price":{"type":["object","null"]},"facts":{"type":"object"},"prices":{"type":"array","items":{"type":"object"}},"source":{"type":"string"},"read_date":{"type":"string"}}}}}}