{"openapi":"3.0.3","info":{"title":"Gnist Context — Wikidata","description":"Structured knowledge base — entities, properties, and relationships from Wikidata.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/wikidata/`\n- **Toolkit page:** `/toolkits/wikidata`\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/wikidata/search_wikidata_entity":{"post":{"tags":["Reference"],"summary":"search_wikidata_entity","description":"Search Wikidata for entities by name or alias.\n\nResolves a natural-language label to one or more Wikidata QIDs. Use this\nas the entry point before calling get_wikidata_entity or get_wikidata_linked_ids.\n\nArgs:\n    label: Name or phrase to search for (e.g. \"Barack Obama\", \"Apple Inc\").\n    language: BCP-47 language code for labels and descriptions. Default \"en\".\n    limit: Maximum results to return (1–20, default 5).\n\nReturns:\n    Dictionary with 'count' and 'results' list. Each result has qid, label,\n    description, and aliases.","operationId":"wikidata_search_wikidata_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":{"label":{"description":"Name or phrase to search for (e.g. \"Barack Obama\", \"Apple Inc\").","type":"string"},"language":{"default":"en","description":"BCP-47 language code for labels and descriptions. Default \"en\".","type":"string"},"limit":{"default":5,"description":"Maximum results to return (1–20, default 5).","type":"integer"}},"required":["label"],"type":"object"}}}}}},"/rest/wikidata/get_wikidata_entity":{"post":{"tags":["Reference"],"summary":"get_wikidata_entity","description":"Fetch a Wikidata entity with its statements, normalized to human-readable form.\n\nReturns the entity's label, description, aliases, and all non-deprecated\nstatements as {property_label: [values]} pairs. Property labels are resolved\nto English names (e.g. \"P569\" → \"date of birth\").\n\nArgs:\n    qid: Wikidata item ID (e.g. \"Q76\" for Barack Obama, \"Q312\" for Apple Inc).\n\nReturns:\n    Entity metadata including statements dict. Statement values are normalized:\n    dates as YYYY-MM-DD, quantities as numbers, entities as \"Label (QID)\",\n    coordinates as \"lat, lon\".","operationId":"wikidata_get_wikidata_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":{"qid":{"description":"Wikidata item ID (e.g. \"Q76\" for Barack Obama, \"Q312\" for Apple Inc).","type":"string"}},"required":["qid"],"type":"object"}}}}}},"/rest/wikidata/get_wikidata_linked_ids":{"post":{"tags":["Reference"],"summary":"get_wikidata_linked_ids","description":"Return all external database identifiers for a Wikidata entity.\n\nFetches all external-id type statements: IMDb, VIAF, ISNI, MusicBrainz,\nGeoNames, OpenCorporates, Freebase, PubMed, ORCID, and many others.\nThis is the bridge between Wikidata and every other database in the MCP toolbox.\n\nArgs:\n    qid: Wikidata item ID (e.g. \"Q76\" for Barack Obama).\n\nReturns:\n    Dictionary with 'qid', 'label', 'wikidata_url', and 'identifiers' —\n    a flat map of {database_name: identifier_value}.","operationId":"wikidata_get_wikidata_linked_ids","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":{"qid":{"description":"Wikidata item ID (e.g. \"Q76\" for Barack Obama).","type":"string"}},"required":["qid"],"type":"object"}}}}}},"/rest/wikidata/wikidata_sparql":{"post":{"tags":["Reference"],"summary":"wikidata_sparql","description":"Execute a SPARQL query against the Wikidata Query Service.\n\nUse for complex relational queries not covered by other tools — e.g.\n\"all EU heads of state born after 1970\", \"Nobel Prize winners in physics since 2000\",\n\"companies headquartered in Oslo with stock exchange listings\".\n\nThe Wikidata SPARQL endpoint uses Blazegraph. Queries must use Wikidata prefixes:\n- wd: (entities), wdt: (direct claims), wikibase:, rdfs:label\nExample: SELECT ?item ?itemLabel WHERE { ?item wdt:P31 wd:Q146. SERVICE wikibase:label { bd:serviceParam wikibase:language \"en\". } }\n\nArgs:\n    query: SPARQL SELECT query string. Must be valid SPARQL 1.1.\n    timeout_s: Query timeout in seconds (default 30, max 55).\n\nReturns:\n    Dictionary with 'columns' list and 'rows' list. Each row is a\n    {variable: value} dict with string values.","operationId":"wikidata_wikidata_sparql","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":"SPARQL SELECT query string. Must be valid SPARQL 1.1.","type":"string"},"timeout_s":{"default":30,"description":"Query timeout in seconds (default 30, max 55).","type":"integer"}},"required":["query"],"type":"object"}}}}}},"/rest/wikidata/report_feedback":{"post":{"tags":["Reference"],"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":"wikidata_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":"Reference","description":"Data sources: Reference"}],"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."}}}}