{"openapi":"3.0.3","info":{"title":"Gnist Context — GLEIF (LEI)","description":"Legal Entity Identifier (LEI) lookup — corporate identity, ownership, and registration.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/gleif/`\n- **Toolkit page:** `/toolkits/gleif`\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/gleif/search_entities":{"post":{"tags":["Legal"],"summary":"search_entities","description":"Search GLEIF for registered legal entities by name, registration number, or jurisdiction.\n\nGLEIF (Global Legal Entity Identifier Foundation) covers 2M+ legal entities in 200+\ncountries. Each entity is identified by a 20-character LEI (ISO 17442) — the global\nstandard mandated for financial reporting under EMIR, MiFID II, Dodd-Frank, and DORA.\n\nAt least one filter parameter must be provided.\n\nArgs:\n    name: Legal name or partial name to search for (e.g. \"Apple Inc\", \"Deutsche Bank\").\n    registration_number: Company registration number from the national registry.\n    jurisdiction: ISO 3166-1 alpha-2 country code (e.g. \"US\", \"DE\", \"NO\", \"GB\").\n    status: Registration status filter — \"ISSUED\" (active), \"LAPSED\" (expired renewal),\n            \"MERGED\", \"RETIRED\", \"PENDING_TRANSFER\", or \"ANNULLED\".\n    limit: Number of results to return (1–50, default 10).\n\nReturns:\n    Dict with 'count' and 'entities' list. Each entity includes lei, name, other_names,\n    jurisdiction, registration_number, registered_address, legal_form, status,\n    next_renewal date, and managing_lou (Local Operating Unit).","operationId":"gleif_search_entities","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":false,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Legal name or partial name to search for (e.g. \"Apple Inc\", \"Deutsche Bank\")."},"registration_number":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Company registration number from the national registry."},"jurisdiction":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ISO 3166-1 alpha-2 country code (e.g. \"US\", \"DE\", \"NO\", \"GB\")."},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Registration status filter — \"ISSUED\" (active), \"LAPSED\" (expired renewal), \"MERGED\", \"RETIRED\", \"PENDING_TRANSFER\", or \"ANNULLED\"."},"limit":{"default":10,"description":"Number of results to return (1–50, default 10).","type":"integer"}},"type":"object"}}}}}},"/rest/gleif/get_entity":{"post":{"tags":["Legal"],"summary":"get_entity","description":"Fetch the full GLEIF record for a Legal Entity Identifier (LEI).\n\nReturns the authoritative entity record as registered with GLEIF — canonical legal name,\nall registered names, jurisdiction, registration number, registered address, legal form,\ncurrent registration status, and next renewal date.\n\nArgs:\n    lei: The 20-character LEI code (e.g. \"HWUPKR0MPOU8FGXBT394\" for Apple Inc).\n\nReturns:\n    Dict with lei, name, other_names, jurisdiction, registration_number,\n    registered_address, legal_form, status, next_renewal, and managing_lou.\n    Returns {\"error\": \"not_found\"} if the LEI does not exist.","operationId":"gleif_get_entity","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":{"lei":{"description":"The 20-character LEI code (e.g. \"HWUPKR0MPOU8FGXBT394\" for Apple Inc).","type":"string"}},"required":["lei"],"type":"object"}}}}}},"/rest/gleif/get_ownership_chain":{"post":{"tags":["Legal"],"summary":"get_ownership_chain","description":"Retrieve ownership chain relationships for a legal entity.\n\nUses GLEIF's relationship data to traverse the corporate ownership structure.\nCovers entities that report their ownership chain as part of LEI registration.\n\nArgs:\n    lei: The 20-character LEI of the entity to look up.\n    direction: Which relationships to retrieve:\n        - \"direct_parent\" — the entity that directly consolidates this one (default)\n        - \"ultimate_parent\" — the topmost parent in the ownership chain\n        - \"children\" — entities directly consolidated by this one (subsidiaries)\n\nReturns:\n    Dict with 'lei', 'direction', 'count', and 'relationships' list.\n    Each relationship includes relationship_type, relationship_status,\n    start_lei (child), and end_lei (parent).\n    Returns empty list if no relationships are registered.","operationId":"gleif_get_ownership_chain","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":{"lei":{"description":"The 20-character LEI of the entity to look up.","type":"string"},"direction":{"default":"direct_parent","description":"Which relationships to retrieve: - \"direct_parent\" — the entity that directly consolidates this one (default) - \"ultimate_parent\" — the topmost parent in the ownership chain - \"children\" — en...","type":"string"}},"required":["lei"],"type":"object"}}}}}},"/rest/gleif/resolve_bic":{"post":{"tags":["Legal"],"summary":"resolve_bic","description":"Resolve a SWIFT BIC code to its corresponding LEI.\n\nUses the GLEIF BIC-to-LEI mapping maintained in cooperation with SWIFT.\nEssential for financial agents processing SWIFT messages or correspondent banking data.\n\nArgs:\n    bic: The SWIFT Bank Identifier Code (8 or 11 characters, e.g. \"DEUTDEDB\").\n\nReturns:\n    Dict with 'bic' and 'lei' if a mapping exists, or {\"error\": \"not_found\"} otherwise.\n    Use get_entity(lei) to retrieve the full entity record for the resolved LEI.","operationId":"gleif_resolve_bic","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":{"bic":{"description":"The SWIFT Bank Identifier Code (8 or 11 characters, e.g. \"DEUTDEDB\").","type":"string"}},"required":["bic"],"type":"object"}}}}}},"/rest/gleif/resolve_isin":{"post":{"tags":["Legal"],"summary":"resolve_isin","description":"Resolve an ISIN (securities identifier) to the issuing entity's LEI.\n\nCovers equities, bonds, and structured products. Enables agents to identify\nthe legal entity behind a financial instrument.\n\nArgs:\n    isin: The 12-character International Securities Identification Number\n          (e.g. \"US0378331005\" for Apple common stock).\n\nReturns:\n    Dict with 'isin' and 'lei' if a mapping exists, or {\"error\": \"not_found\"} otherwise.\n    Use get_entity(lei) to retrieve the full entity record for the resolved LEI.","operationId":"gleif_resolve_isin","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":{"isin":{"description":"The 12-character International Securities Identification Number (e.g. \"US0378331005\" for Apple common stock).","type":"string"}},"required":["isin"],"type":"object"}}}}}},"/rest/gleif/report_feedback":{"post":{"tags":["Legal"],"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":"gleif_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":"Legal","description":"Data sources: Legal"}],"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."}}}}