{"openapi":"3.0.3","info":{"title":"Gnist Context — Global Tenders","description":"EU public procurement notices — contract opportunities and award results.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/global-tenders/`\n- **Toolkit page:** `/toolkits/global-tenders`\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/global-tenders/search_tenders":{"post":{"tags":["Legal"],"summary":"search_tenders","description":"Search active public procurement notices (tenders) across EU, UK, and US sources.\n\nArgs:\n    query: Full-text search term (e.g. \"software development\", \"road construction\").\n    country: ISO 3166-1 alpha-2 country code to restrict search (e.g. \"DE\", \"NO\", \"GB\", \"US\").\n             Omit to search all EU countries via TED.\n    sector_cpv: CPV code prefix to filter by sector (e.g. \"72000000\" for IT services).\n                Only applied for EU/TED searches.\n    date_from: ISO 8601 date (YYYY-MM-DD) — only return notices published on or after this date.\n    value_min_eur: Minimum estimated contract value in EUR.\n    limit: Maximum number of results to return (1-50, default 10).\n\nReturns:\n    List of tender notices with title, contracting authority, country, deadline,\n    estimated value, CPV codes, and source URL.","operationId":"global_tenders_search_tenders","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":{"query":{"description":"Full-text search term (e.g. \"software development\", \"road construction\").","type":"string"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ISO 3166-1 alpha-2 country code to restrict search (e.g. \"DE\", \"NO\", \"GB\", \"US\"). Omit to search all EU countries via TED."},"sector_cpv":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"CPV code prefix to filter by sector (e.g. \"72000000\" for IT services). Only applied for EU/TED searches."},"date_from":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ISO 8601 date (YYYY-MM-DD) — only return notices published on or after this date."},"value_min_eur":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Minimum estimated contract value in EUR."},"limit":{"default":10,"description":"Maximum number of results to return (1-50, default 10).","type":"integer"}},"required":["query"],"type":"object"}}}}}},"/rest/global-tenders/get_tender":{"post":{"tags":["Legal"],"summary":"get_tender","description":"Get full details for a specific EU TED procurement notice by document number.\n\nArgs:\n    notice_id: TED notice document number (e.g. \"123456-2024\").\n               Retrieve this from search_tenders results.\n\nReturns:\n    Full notice details including title, contracting authority, country,\n    published date, deadline, estimated value, CPV codes, and source URL.","operationId":"global_tenders_get_tender","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":{"notice_id":{"description":"TED notice document number (e.g. \"123456-2024\"). Retrieve this from search_tenders results.","type":"string"}},"required":["notice_id"],"type":"object"}}}}}},"/rest/global-tenders/get_awarded_contracts":{"post":{"tags":["Legal"],"summary":"get_awarded_contracts","description":"Get recently awarded public contracts from EU TED, UK Find a Tender, or US SAM.gov.\n\nArgs:\n    country: ISO 3166-1 alpha-2 country code (e.g. \"DE\", \"NO\", \"GB\", \"US\").\n             Omit for all EU countries.\n    sector_cpv: CPV code prefix to filter by sector. Only applied for EU/TED searches.\n    year: Calendar year to filter awards. Omit for most recent.\n    limit: Maximum number of results to return (1-50, default 10).\n\nReturns:\n    List of awarded contracts with contracting authority, winner (where available),\n    value, award date, country, and CPV codes.","operationId":"global_tenders_get_awarded_contracts","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":{"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ISO 3166-1 alpha-2 country code (e.g. \"DE\", \"NO\", \"GB\", \"US\"). Omit for all EU countries."},"sector_cpv":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"CPV code prefix to filter by sector. Only applied for EU/TED searches."},"year":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Calendar year to filter awards. Omit for most recent."},"limit":{"default":10,"description":"Maximum number of results to return (1-50, default 10).","type":"integer"}},"type":"object"}}}}}},"/rest/global-tenders/search_by_winner":{"post":{"tags":["Legal"],"summary":"search_by_winner","description":"Find public contracts won by a named company.\n\nArgs:\n    company_name: Company name to search for (e.g. \"Accenture\", \"IBM\").\n    country: ISO 3166-1 alpha-2 country code to restrict search.\n    year_from: Start year for award date filter (inclusive).\n    year_to: End year for award date filter (inclusive).\n    limit: Maximum number of results to return (1-50, default 10).\n\nReturns:\n    List of award notices where the winner name matches the query.","operationId":"global_tenders_search_by_winner","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":{"company_name":{"description":"Company name to search for (e.g. \"Accenture\", \"IBM\").","type":"string"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ISO 3166-1 alpha-2 country code to restrict search."},"year_from":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Start year for award date filter (inclusive)."},"year_to":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"End year for award date filter (inclusive)."},"limit":{"default":10,"description":"Maximum number of results to return (1-50, default 10).","type":"integer"}},"required":["company_name"],"type":"object"}}}}}},"/rest/global-tenders/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":"global_tenders_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."}}}}