{"openapi":"3.0.3","info":{"title":"Gnist Context — ORCID","description":"Researcher identity profiles — career history, publications, and funding via ORCID.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/orcid/`\n- **Toolkit page:** `/toolkits/orcid`\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/orcid/search_researchers":{"post":{"tags":["Science"],"summary":"search_researchers","description":"Search ORCID for researchers by name, keyword, or affiliation.\n\nORCID is the universal researcher identifier with 20M+ profiles. Use this\nto find researchers and get their canonical ORCID IDs for cross-referencing\nwith CrossRef, OpenAlex, and PubMed.\n\nArgs:\n    query: Search query — researcher name, keyword, or ORCID ID fragment.\n           Supports Solr syntax (e.g. \"given-names:Albert AND family-name:Einstein\").\n    affiliation: Filter by affiliated organization name (e.g. \"MIT\", \"CERN\").\n    rows: Number of results to return (1-50, default 10).\n\nReturns:\n    Dict with 'count' (returned), 'total_results' (total matches), and 'researchers' list.\n    Each researcher includes orcid_id, given_name, family_name, and credit_name.","operationId":"orcid_search_researchers","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":"Search query — researcher name, keyword, or ORCID ID fragment. Supports Solr syntax (e.g. \"given-names:Albert AND family-name:Einstein\").","type":"string"},"affiliation":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by affiliated organization name (e.g. \"MIT\", \"CERN\")."},"rows":{"default":10,"description":"Number of results to return (1-50, default 10).","type":"integer"}},"required":["query"],"type":"object"}}}}}},"/rest/orcid/get_researcher_profile":{"post":{"tags":["Science"],"summary":"get_researcher_profile","description":"Fetch a researcher's full profile by ORCID ID.\n\nReturns biographical details, keywords, employment history, and education.\nUse this to understand a researcher's career trajectory and current affiliations.\n\nArgs:\n    orcid_id: The ORCID identifier. Accepts bare ID (e.g. \"0000-0002-1825-0097\")\n              or full URL (e.g. \"https://orcid.org/0000-0002-1825-0097\").\n\nReturns:\n    Dict with orcid_id, given_name, family_name, credit_name, biography,\n    keywords, employments (organization/role/dates), and educations.","operationId":"orcid_get_researcher_profile","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":{"orcid_id":{"description":"The ORCID identifier. Accepts bare ID (e.g. \"0000-0002-1825-0097\") or full URL (e.g. \"https://orcid.org/0000-0002-1825-0097\").","type":"string"}},"required":["orcid_id"],"type":"object"}}}}}},"/rest/orcid/get_researcher_works":{"post":{"tags":["Science"],"summary":"get_researcher_works","description":"Fetch a researcher's published works by ORCID ID.\n\nReturns publications with DOIs that can be cross-referenced with CrossRef\n(resolve_doi) and OpenAlex for citation data and full metadata.\n\nArgs:\n    orcid_id: The ORCID identifier (bare or URL form).\n    max_results: Maximum number of works to return (1-100, default 25).\n\nReturns:\n    Dict with 'count' and 'works' list. Each work includes title, doi,\n    work_type, publication_date, journal, url, and external_ids.","operationId":"orcid_get_researcher_works","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":{"orcid_id":{"description":"The ORCID identifier (bare or URL form).","type":"string"},"max_results":{"default":25,"description":"Maximum number of works to return (1-100, default 25).","type":"integer"}},"required":["orcid_id"],"type":"object"}}}}}},"/rest/orcid/get_researcher_funding":{"post":{"tags":["Science"],"summary":"get_researcher_funding","description":"Fetch a researcher's grants and funding records by ORCID ID.\n\nReturns funding sources, amounts, and dates. Useful for understanding\na researcher's funding landscape and institutional backing.\n\nArgs:\n    orcid_id: The ORCID identifier (bare or URL form).\n\nReturns:\n    Dict with 'count' and 'fundings' list. Each funding includes title,\n    funder, funding_type, amount, currency, start/end dates, and url.","operationId":"orcid_get_researcher_funding","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":{"orcid_id":{"description":"The ORCID identifier (bare or URL form).","type":"string"}},"required":["orcid_id"],"type":"object"}}}}}},"/rest/orcid/report_feedback":{"post":{"tags":["Science"],"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":"orcid_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":"Science","description":"Data sources: Science"}],"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."}}}}