{"openapi":"3.0.3","info":{"title":"Gnist Context — GitHub","description":"Public GitHub data — repositories, issues, pull requests, and user profiles.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/github/`\n- **Toolkit page:** `/toolkits/github`\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/github/search_repos":{"post":{"tags":["Software"],"summary":"search_repos","description":"Search public GitHub repositories by keyword.\n\nReturns up to 10 repositories ranked by star count.\n\nArgs:\n    query: Search terms (e.g. \"machine learning framework\", \"http client\").\n    language: Filter by programming language (e.g. \"python\", \"typescript\"). Optional.\n    stars_min: Minimum star count filter (e.g. 100). Optional.\n\nReturns:\n    List of repositories with full_name, description, stars, forks, language,\n    license (SPDX id), last_pushed (ISO 8601), topics, and url.","operationId":"github_search_repos","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 terms (e.g. \"machine learning framework\", \"http client\").","type":"string"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by programming language (e.g. \"python\", \"typescript\"). Optional."},"stars_min":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Minimum star count filter (e.g. 100). Optional."}},"required":["query"],"type":"object"}}}}}},"/rest/github/get_readme":{"post":{"tags":["Software"],"summary":"get_readme","description":"Fetch and decode the README for a GitHub repository.\n\nUseful for understanding what a project does before recommending it.\n\nArgs:\n    owner: Repository owner (user or org), e.g. \"fastapi\".\n    repo: Repository name, e.g. \"fastapi\".\n\nReturns:\n    Object with owner, repo, and content (raw README text, typically Markdown).","operationId":"github_get_readme","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":{"owner":{"description":"Repository owner (user or org), e.g. \"fastapi\".","type":"string"},"repo":{"description":"Repository name, e.g. \"fastapi\".","type":"string"}},"required":["owner","repo"],"type":"object"}}}}}},"/rest/github/list_open_issues":{"post":{"tags":["Software"],"summary":"list_open_issues","description":"List open issues for a public GitHub repository.\n\nPull requests are excluded. Returns up to 30 issues, newest first.\n\nArgs:\n    owner: Repository owner (user or org), e.g. \"django\".\n    repo: Repository name, e.g. \"django\".\n    labels: Filter by label names (e.g. [\"bug\", \"help wanted\"]). Optional.\n\nReturns:\n    List of issues with number, title, state, author, labels, created_at,\n    updated_at, and url.","operationId":"github_list_open_issues","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":{"owner":{"description":"Repository owner (user or org), e.g. \"django\".","type":"string"},"repo":{"description":"Repository name, e.g. \"django\".","type":"string"},"labels":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Filter by label names (e.g. [\"bug\", \"help wanted\"]). Optional."}},"required":["owner","repo"],"type":"object"}}}}}},"/rest/github/get_repo_stats":{"post":{"tags":["Software"],"summary":"get_repo_stats","description":"Get metadata and statistics for a specific public GitHub repository.\n\nArgs:\n    owner: Repository owner (user or org), e.g. \"astral-sh\".\n    repo: Repository name, e.g. \"ruff\".\n\nReturns:\n    Repository metadata: full_name, description, stars, forks, language,\n    license (SPDX id), last_pushed (ISO 8601), topics, and url.","operationId":"github_get_repo_stats","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":{"owner":{"description":"Repository owner (user or org), e.g. \"astral-sh\".","type":"string"},"repo":{"description":"Repository name, e.g. \"ruff\".","type":"string"}},"required":["owner","repo"],"type":"object"}}}}}},"/rest/github/report_feedback":{"post":{"tags":["Software"],"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":"github_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":"Software","description":"Data sources: Software"}],"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."}}}}