{"openapi":"3.1.0","info":{"title":"DrugBank (BYOK) API","version":"0.1.0","description":"DrugBank (BYOK) lets an AI assistant read your own DrugBank data through the DrugBank API with a key you supply (DrugBank API key). Read-only: 8 tools (search_drug_names, search_ingredient_names, search_product_concepts, get_product, list_product_categories, list_product_indications, list_product_interactions, list_product_adverse_effects). The BYOK key travels with each request, is used for that...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-drugbank.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-drugbank/docs"},"termsOfService":"https://connectorbay.com/byok-drugbank/terms"},"servers":[{"url":"https://byok-drugbank.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-drugbank/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_drug_names":{"post":{"operationId":"search_drug_names","summary":"Search drug products by brand or generic name: product name, prescribable name, country, dosage form, strength, route, a","description":"Search drug products by brand or generic name: product name, prescribable name, country, dosage form, strength, route, approved, generic and OTC flags and ingredients. Use for \"Which products are called Lipitor in DrugBank\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"q":{"description":"Name to search for, for example 'atorvastatin' or 'Lipitor'.","maxLength":100,"title":"Q","type":"string"},"fuzzy":{"anyOf":[{"enum":["0","1","2"],"type":"string"},{"type":"null"}],"default":"0","description":"Tolerate misspellings: 0 off, 1 or 2 allowed misspellings.","title":"Fuzzy"},"include_allergens":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to include allergen products.","title":"Include Allergens"},"include_vaccines":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":true,"description":"False to leave out vaccine products (default true).","title":"Include Vaccines"},"region":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only products of this region code (at, ca, co, eu, idn, it, my, sg, th, tr, us); several can be comma-separated. Multi-region licences must set it for product lookups.","title":"Region"}},"required":["q"],"title":"search_drug_namesArguments","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_ingredient_names":{"post":{"operationId":"search_ingredient_names","summary":"Search active ingredients by name and get their DrugBank IDs and CAS numbers. Use for \"What is the DrugBank ID of ibupro","description":"Search active ingredients by name and get their DrugBank IDs and CAS numbers. Use for \"What is the DrugBank ID of ibuprofen\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"q":{"description":"Ingredient name to search for, for example 'ibuprofen'.","maxLength":100,"title":"Q","type":"string"},"fuzzy":{"anyOf":[{"enum":["0","1","2"],"type":"string"},{"type":"null"}],"default":"0","description":"Tolerate misspellings: 0 off, 1 or 2 allowed misspellings.","title":"Fuzzy"}},"required":["q"],"title":"search_ingredient_namesArguments","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_product_concepts":{"post":{"operationId":"search_product_concepts","summary":"Search product concepts (a medication grouped by ingredient, route, form and strength) by text: name, DrugBank concept I","description":"Search product concepts (a medication grouped by ingredient, route, form and strength) by text: name, DrugBank concept ID, level, brand, route, form, strengths, standing and regions. Use for \"Find the DrugBank product concepts for amoxicillin\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"q":{"description":"Text to search for, for example 'amoxicillin'.","maxLength":100,"title":"Q","type":"string"},"query_type":{"anyOf":[{"enum":["simple","advanced","exact"],"type":"string"},{"type":"null"}],"default":"simple","description":"simple (default), advanced (boolean operators) or exact.","title":"Query Type"},"level":{"anyOf":[{"maximum":10,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Only concepts of this level (1 is the ingredient level; higher adds route, form, strength).","title":"Level"},"unbranded_only":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True for concepts without a brand only.","title":"Unbranded Only"},"region":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only products of this region code (at, ca, co, eu, idn, it, my, sg, th, tr, us); several can be comma-separated. Multi-region licences must set it for product lookups.","title":"Region"}},"required":["q"],"title":"search_product_conceptsArguments","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_product":{"post":{"operationId":"get_product","summary":"Get one drug product by its local ID: name, prescribable name, country, dosage form, strength, route, approval flags and","description":"Get one drug product by its local ID: name, prescribable name, country, dosage form, strength, route, approval flags and ingredients. Use for \"Show DrugBank details for the product with NDC 50090-5181\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"product_id":{"description":"Local product ID in the region's format, for example a US NDC such as '50090-5181' (Canada: DIN, EU: MA number). Found in the product codes of search_drug_names.","maxLength":60,"title":"Product Id","type":"string"},"region":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only products of this region code (at, ca, co, eu, idn, it, my, sg, th, tr, us); several can be comma-separated. Multi-region licences must set it for product lookups.","title":"Region"}},"required":["product_id"],"title":"get_productArguments","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_product_categories":{"post":{"operationId":"list_product_categories","summary":"List a product's ATC or MeSH classifications with IDs, codes, levels, synonyms and descriptions. Use for \"Which ATC clas","description":"List a product's ATC or MeSH classifications with IDs, codes, levels, synonyms and descriptions. Use for \"Which ATC classes does product 50090-5181 belong to\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"product_id":{"description":"Local product ID in the region's format, for example a US NDC such as '50090-5181' (Canada: DIN, EU: MA number). Found in the product codes of search_drug_names.","maxLength":60,"title":"Product Id","type":"string"},"hierarchy":{"description":"Classification to list: atc or mesh.","enum":["atc","mesh"],"title":"Hierarchy","type":"string"},"region":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only products of this region code (at, ca, co, eu, idn, it, my, sg, th, tr, us); several can be comma-separated. Multi-region licences must set it for product lookups.","title":"Region"},"page":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"per_page":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"Results per page (1 to 50, default 50).","title":"Per Page"}},"required":["product_id","hierarchy"],"title":"list_product_categoriesArguments","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_product_indications":{"post":{"operationId":"list_product_indications","summary":"List what a product is indicated for: condition, kind, off-label, OTC and adjunct flags, routes, dose forms and age grou","description":"List what a product is indicated for: condition, kind, off-label, OTC and adjunct flags, routes, dose forms and age groups. Reference information only. Use for \"What is product 50090-5181 indicated for\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"product_id":{"description":"Local product ID in the region's format, for example a US NDC such as '50090-5181' (Canada: DIN, EU: MA number). Found in the product codes of search_drug_names.","maxLength":60,"title":"Product Id","type":"string"},"off_label":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True for off-label indications only, false to exclude them.","title":"Off Label"},"otc_use":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True for OTC indications only, false to exclude them.","title":"Otc Use"},"region":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only products of this region code (at, ca, co, eu, idn, it, my, sg, th, tr, us); several can be comma-separated. Multi-region licences must set it for product lookups.","title":"Region"},"page":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"per_page":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"Results per page (1 to 50, default 50).","title":"Per Page"}},"required":["product_id"],"title":"list_product_indicationsArguments","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_product_interactions":{"post":{"operationId":"list_product_interactions","summary":"List documented drug-drug interactions of a product's ingredients with description, action, severity and evidence level.","description":"List documented drug-drug interactions of a product's ingredients with description, action, severity and evidence level. Reference information, not medical advice. Use for \"Which major interactions does product 50090-5181 have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"product_id":{"description":"Local product ID in the region's format, for example a US NDC such as '50090-5181' (Canada: DIN, EU: MA number). Found in the product codes of search_drug_names.","maxLength":60,"title":"Product Id","type":"string"},"severity":{"anyOf":[{"enum":["major","moderate","minor"],"type":"string"},{"type":"null"}],"default":null,"description":"Only interactions of this severity.","title":"Severity"},"evidence_level":{"anyOf":[{"enum":["level_1","level_2"],"type":"string"},{"type":"null"}],"default":null,"description":"Only interactions with this evidence level.","title":"Evidence Level"},"region":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only products of this region code (at, ca, co, eu, idn, it, my, sg, th, tr, us); several can be comma-separated. Multi-region licences must set it for product lookups.","title":"Region"},"page":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"per_page":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"Results per page (1 to 50, default 50).","title":"Per Page"}},"required":["product_id"],"title":"list_product_interactionsArguments","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_product_adverse_effects":{"post":{"operationId":"list_product_adverse_effects","summary":"List documented adverse effects of a product with the effect name, routes, evidence type and reported incidences. Refere","description":"List documented adverse effects of a product with the effect name, routes, evidence type and reported incidences. Reference information only. Use for \"What adverse effects are documented for product 50090-5181\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"product_id":{"description":"Local product ID in the region's format, for example a US NDC such as '50090-5181' (Canada: DIN, EU: MA number). Found in the product codes of search_drug_names.","maxLength":60,"title":"Product Id","type":"string"},"region":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only products of this region code (at, ca, co, eu, idn, it, my, sg, th, tr, us); several can be comma-separated. Multi-region licences must set it for product lookups.","title":"Region"},"page":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"per_page":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"Results per page (1 to 50, default 50).","title":"Per Page"}},"required":["product_id"],"title":"list_product_adverse_effectsArguments","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}}}}