{"openapi":"3.1.0","info":{"title":"Financial Modeling Prep Reference (BYOK) API","version":"0.1.0","description":"Financial Modeling Prep Reference (BYOK) lets an AI assistant read your own Financial Modeling Prep Reference data through the Financial Modeling Prep Reference API with a key you supply (API key). Read-only: 11 tools (search_company_by_name, search_company_by_cik, search_company_by_cusip, search_company_by_isin, search_exchange_variants, list_cik_directory, list_symbol_changes,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-fmp-reference.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-fmp-reference/docs"},"termsOfService":"https://connectorbay.com/byok-fmp-reference/terms"},"servers":[{"url":"https://byok-fmp-reference.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-fmp-reference/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/search_company_by_name":{"post":{"operationId":"search_company_by_name","summary":"Search listed companies and securities by company name; returns matching symbols with the name and exchange. Some endpoi","description":"Search listed companies and securities by company name; returns matching symbols with the name and exchange. Some endpoints may need a paid plan. Use for \"Which listed companies have Tesla in their name\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Company name or part of it, for example 'tesla'.","maxLength":100,"title":"Query","type":"string"}},"required":["query"],"title":"search_company_by_nameArguments","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/search_company_by_cik":{"post":{"operationId":"search_company_by_cik","summary":"Find the listed symbol and company name for a SEC Central Index Key (CIK). Some endpoints may need a paid plan. Use for ","description":"Find the listed symbol and company name for a SEC Central Index Key (CIK). Some endpoints may need a paid plan. Use for \"Which company has SEC CIK 320193\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"cik":{"description":"SEC Central Index Key, digits only, for example 320193.","maxLength":12,"title":"Cik","type":"string"}},"required":["cik"],"title":"search_company_by_cikArguments","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/search_company_by_cusip":{"post":{"operationId":"search_company_by_cusip","summary":"Find the listed symbol and company name for a CUSIP security identifier. Some endpoints may need a paid plan. Use for \"W","description":"Find the listed symbol and company name for a CUSIP security identifier. Some endpoints may need a paid plan. Use for \"Which company has CUSIP 037833100\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"cusip":{"description":"Nine-character CUSIP, for example 037833100.","maxLength":9,"title":"Cusip","type":"string"}},"required":["cusip"],"title":"search_company_by_cusipArguments","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/search_company_by_isin":{"post":{"operationId":"search_company_by_isin","summary":"Find the listed symbol and company name for an ISIN security identifier. Some endpoints may need a paid plan. Use for \"W","description":"Find the listed symbol and company name for an ISIN security identifier. Some endpoints may need a paid plan. Use for \"Which company has ISIN US0378331005\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"isin":{"description":"Twelve-character ISIN, for example US0378331005.","maxLength":12,"title":"Isin","type":"string"}},"required":["isin"],"title":"search_company_by_isinArguments","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/search_exchange_variants":{"post":{"operationId":"search_exchange_variants","summary":"List the listings of one company across exchanges for a symbol. Some endpoints may need a paid plan. Use for \"On which e","description":"List the listings of one company across exchanges for a symbol. Some endpoints may need a paid plan. Use for \"On which exchanges is AAPL listed\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"symbol":{"description":"Ticker symbol, for example AAPL.","maxLength":20,"title":"Symbol","type":"string"}},"required":["symbol"],"title":"search_exchange_variantsArguments","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_cik_directory":{"post":{"operationId":"list_cik_directory","summary":"Page through the directory of SEC CIK numbers and the company names attached to them. Some endpoints may need a paid pla","description":"Page through the directory of SEC CIK numbers and the company names attached to them. Some endpoints may need a paid plan. Use for \"List some SEC CIK numbers with their company names\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"page":{"anyOf":[{"maximum":10000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Page number, starting at 0.","title":"Page"},"limit":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"How many entries per page (1 to 1000).","title":"Limit"}},"title":"list_cik_directoryArguments","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_symbol_changes":{"post":{"operationId":"list_symbol_changes","summary":"List recent ticker symbol changes, with old and new symbols. Some endpoints may need a paid plan. Use for \"Which tickers","description":"List recent ticker symbol changes, with old and new symbols. Some endpoints may need a paid plan. Use for \"Which tickers were renamed recently\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_symbol_changesArguments","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_available_exchanges":{"post":{"operationId":"list_available_exchanges","summary":"List the stock exchanges the data service covers. Some endpoints may need a paid plan. Use for \"Which exchanges does Fin","description":"List the stock exchanges the data service covers. Some endpoints may need a paid plan. Use for \"Which exchanges does Financial Modeling Prep cover\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_available_exchangesArguments","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_available_sectors":{"post":{"operationId":"list_available_sectors","summary":"List the sector names used to classify companies. Some endpoints may need a paid plan. Use for \"Which sectors can compan","description":"List the sector names used to classify companies. Some endpoints may need a paid plan. Use for \"Which sectors can companies be classified in\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_available_sectorsArguments","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_available_industries":{"post":{"operationId":"list_available_industries","summary":"List the industry names used to classify companies. Some endpoints may need a paid plan. Use for \"Which industries can c","description":"List the industry names used to classify companies. Some endpoints may need a paid plan. Use for \"Which industries can companies be classified in\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_available_industriesArguments","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_available_countries":{"post":{"operationId":"list_available_countries","summary":"List the countries with listed companies in the data service. Some endpoints may need a paid plan. Use for \"Which countr","description":"List the countries with listed companies in the data service. Some endpoints may need a paid plan. Use for \"Which countries have listed companies in the dataset\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_available_countriesArguments","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}}}}