Software

Data source: GitHub API

MCP Endpoint (Streamable HTTP) https://context.gnist.ai/mcp/github/

Authentication

All requests require a Gnist-API-Key header (or api_key query parameter).

Free tier: 100 calls/day. Get your API key.

Tools (5)

search_repos
get_readme
list_open_issues
get_repo_stats
report_feedback

search_repos

Search public GitHub repositories by keyword.

Returns up to 10 repositories ranked by star count.

Args:
query: Search terms (e.g. "machine learning framework", "http client").
language: Filter by programming language (e.g. "python", "typescript"). Optional.
stars_min: Minimum star count filter (e.g. 100). Optional.

Returns:
List of repositories with full_name, description, stars, forks, language,
license (SPDX id), last_pushed (ISO 8601), topics, and url.

Parameter	Type	Required	Description
`query`	`string`	required	Search terms (e.g. "machine learning framework", "http client").
`language`	`any`	optional	Filter by programming language (e.g. "python", "typescript"). Optional.
`stars_min`	`any`	optional	Minimum star count filter (e.g. 100). Optional.

JSON-RPC Request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 1,
  "params": {
    "name": "search_repos",
    "arguments": {
      "query": "example"
    }
  }
}

get_readme

Fetch and decode the README for a GitHub repository.

Useful for understanding what a project does before recommending it.

Args:
owner: Repository owner (user or org), e.g. "fastapi".
repo: Repository name, e.g. "fastapi".

Returns:
Object with owner, repo, and content (raw README text, typically Markdown).

Parameter	Type	Required	Description
`owner`	`string`	required	Repository owner (user or org), e.g. "fastapi".
`repo`	`string`	required	Repository name, e.g. "fastapi".

JSON-RPC Request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 1,
  "params": {
    "name": "get_readme",
    "arguments": {
      "owner": "123456789",
      "repo": "example"
    }
  }
}

list_open_issues

List open issues for a public GitHub repository.

Pull requests are excluded. Returns up to 30 issues, newest first.

Args:
owner: Repository owner (user or org), e.g. "django".
repo: Repository name, e.g. "django".
labels: Filter by label names (e.g. ["bug", "help wanted"]). Optional.

Returns:
List of issues with number, title, state, author, labels, created_at,
updated_at, and url.

Parameter	Type	Required	Description
`owner`	`string`	required	Repository owner (user or org), e.g. "django".
`repo`	`string`	required	Repository name, e.g. "django".
`labels`	`any`	optional	Filter by label names (e.g. ["bug", "help wanted"]). Optional.

JSON-RPC Request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 1,
  "params": {
    "name": "list_open_issues",
    "arguments": {
      "owner": "123456789",
      "repo": "example"
    }
  }
}

get_repo_stats

Get metadata and statistics for a specific public GitHub repository.

Args:
owner: Repository owner (user or org), e.g. "astral-sh".
repo: Repository name, e.g. "ruff".

Returns:
Repository metadata: full_name, description, stars, forks, language,
license (SPDX id), last_pushed (ISO 8601), topics, and url.

Parameter	Type	Required	Description
`owner`	`string`	required	Repository owner (user or org), e.g. "astral-sh".
`repo`	`string`	required	Repository name, e.g. "ruff".

JSON-RPC Request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 1,
  "params": {
    "name": "get_repo_stats",
    "arguments": {
      "owner": "123456789",
      "repo": "example"
    }
  }
}

report_feedback

Report a bug, feature request, or general feedback for this data source.

Use this when something doesn't work as expected, when you'd like
a new feature, or when you have suggestions for improvement.

Args:
feedback: Describe the issue or suggestion.
feedback_type: One of 'bug', 'feature_request', or 'general'.

Parameter	Type	Required	Description
`feedback`	`string`	required
`feedback_type`	`string`	optional	(default: "general")

JSON-RPC Request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 1,
  "params": {
    "name": "report_feedback",
    "arguments": {
      "feedback": "example"
    }
  }
}

Quick Start

Shell

curl -X POST "https://context.gnist.ai/mcp/github/" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "search_repos", "arguments": {"query": "example"}}}'

Python

import httpx

resp = httpx.post(
    "https://context.gnist.ai/mcp/github/",
    headers={"Gnist-API-Key": "YOUR_API_KEY", "Content-Type": "application/json"},
    json={
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 1,
  "params": {
    "name": "search_repos",
    "arguments": {
      "query": "example"
    }
  }
},
)
print(resp.json())

Related Toolkits (Software)

Hacker News

Hacker News stories, comments, and discussions from the tech community.

Package Registry

Package metadata and vulnerability data from npm, PyPI, crates.io, and OSV.

Resources

Toolkit Overview

Landing page with health status and quick start.

Tool Schemas (JSON)

Full input/output JSON schemas for all tools.

Developer Quickstart

Get from zero to your first API call in under two minutes.

Get an API Key

Free tier: 100 calls/day. No credit card required.