{"openapi":"3.0.3","info":{"title":"Gnist Context — BIN Lookup","description":"BIN (Bank Identification Number) lookup — identify card brand, type, and category from the first 6-8 digits.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/bin-lookup/`\n- **Toolkit page:** `/toolkits/bin-lookup`\n- **Full API spec:** `/api/openapi.json`\n- **Get an API key:** `/signup`","version":"1.0.0","contact":{"name":"GnistAI","url":"https://gnist.ai"}},"servers":[{"url":"https://context.gnist.ai","description":"Production"}],"paths":{"/rest/bin-lookup/lookup_bin":{"post":{"tags":["Finance"],"summary":"lookup_bin","description":"Identify the card brand, type, and category from a Bank Identification Number (BIN).\n\nMatches the input against well-known public BIN prefix ranges for Visa,\nMastercard, American Express, Discover, JCB, UnionPay, Diners Club, and Maestro.\n\nArgs:\n    bin_digits: The first 6-8 digits of a payment card number.","operationId":"bin_lookup_lookup_bin","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"bin_digits":{"description":"First 6-8 digits of a payment card number.","type":"string"}},"required":["bin_digits"],"type":"object"}}}}}},"/rest/bin-lookup/get_card_brands":{"post":{"tags":["Finance"],"summary":"get_card_brands","description":"List all card brands that can be identified from BIN prefixes.\n\nReturns the sorted list of known card brands (e.g. Visa, Mastercard, etc.).","operationId":"bin_lookup_get_card_brands","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}]}},"/rest/bin-lookup/report_feedback":{"post":{"tags":["Finance"],"summary":"report_feedback","description":"Report a bug, feature request, or general feedback for this data source.\n\nUse this when something doesn't work as expected, when you'd like\na new feature, or when you have suggestions for improvement.\n\nArgs:\n    feedback: Describe the issue or suggestion.\n    feedback_type: One of 'bug', 'feature_request', or 'general'.","operationId":"bin_lookup_report_feedback","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"feedback":{"type":"string"},"feedback_type":{"default":"general","type":"string"}},"required":["feedback"],"type":"object"}}}}}}},"tags":[{"name":"Finance","description":"Data sources: Finance"}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"gnist-api-key","description":"API key passed via request header."},"ApiKeyQuery":{"type":"apiKey","in":"query","name":"gnist_api_key","description":"API key passed via query parameter."}}}}