Git.Top Grp API
The Grp API from Git.Top — 1 operation(s) for grp.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/git-top:git-top-grp-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Git.Top Agent Grp API
version: 0.1.0
description: Agent-native GitHub project knowledge API for search, project lookup, alternatives, comparison, graph reasoning, quality, and schema discovery. High-confidence clients should inspect metadata.source, metadata.reason, trust fields, classification evidence, quality_signal_confidence, verification signals, and migration validation steps, and use require_d1=true when seed fallback should fail closed.
servers:
- url: https://git.top
description: Production
- url: http://localhost:8787
description: Local Worker
tags:
- name: Grp
paths:
/api/grp/query:
post:
summary: Run Graph Reasoning Protocol over the knowledge graph
parameters:
- name: require_d1
in: query
required: false
description: Fail closed unless D1-backed data is available
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/GrpRequest'
responses:
'200':
description: Graph-grounded project set, plan, comparison, or stack
content:
application/json:
schema:
$ref: '#/components/schemas/GrpResponse'
example:
intent: find a Cloudflare-ready agent framework
mode: find
result_type: project_set
sub_goals:
- cloudflare
- agent framework
nodes:
- id: cloudflare/agents
label: agents
kind: project
score:
final_score: 92
reasons:
- Matches Cloudflare deployment.
edges:
- source: cloudflare/agents
target: deployment:cloudflare
kind: deployment
weight: 92
reason: Deployment compatibility.
solution_paths: []
recommended_stack: []
alternatives: []
explanation:
- GRP interpreted the goal as find a Cloudflare-ready agent framework.
evidence:
source_fields:
- grp.request
- grp.decomposition
- grp.seeds
- grp.nodes
- grp.edges
- grp.solution_paths
- grp.recommended_stack
- verification.signals
caveats: []
confidence_reason: GRP result is grounded in retrieved seed projects, graph nodes, and relationship or path evidence.
verification:
schema_version: git-top.verification.v1
overall_status: partial
observed_at: '2026-07-04T00:00:00.000Z'
signals:
activity:
status: observed
source: github_metadata
evidence:
- project.pushed_at
- metrics.recent_push_days
license:
status: observed
source: github_metadata
evidence:
- project.license
documentation:
status: observed
source: github_metadata
evidence:
- project.description
runtime:
status: inferred
source: git_top_heuristic
evidence:
- agent_card.deployment
- agent_card.cloudflare_ready
install:
status: not_run
source: git_top_runtime
evidence:
- installation/build probe is not enabled
security:
status: not_run
source: git_top_runtime
evidence:
- dependency/security scan is not enabled
mcp:
status: not_applicable
source: git_top_runtime
evidence:
- project is not classified as mcp_server
coverage:
observed: 3
inferred: 1
not_run: 2
unknown: 0
next_steps:
- Run an installation/build probe before production adoption.
- Run a dependency and security scan before treating the score as a trust claim.
last_verified_at: '2026-07-04T00:00:00.000Z'
caveats: []
confidence_reason: GRP result is grounded in retrieved seed projects, graph nodes, and relationship or path evidence.
source_fields:
- grp.request
- grp.decomposition
- grp.seeds
- grp.nodes
- grp.edges
- grp.solution_paths
- grp.recommended_stack
- verification.signals
last_verified_at: '2026-07-04T00:00:00.000Z'
metadata:
version: grp.v1
generated_at: '2026-07-04T00:00:00.000Z'
candidate_count: 1
max_depth: 2
data_source:
source: d1
reason: d1_query
project_count: 500
generated_at: '2026-07-04T00:00:00.000Z'
snapshot_id: d1:500:2026-07-04T00:00:00.000Z
latest_synced_at: '2026-07-04T00:00:00.000Z'
schema_version: git-top.knowledge.v1
tags:
- Grp
operationId: postApiGrpQuery
x-operation-id-source: derived
components:
schemas:
GrpResponse:
type: object
description: Graph Reasoning Protocol result for planning, composing, comparing, or finding project sets.
properties:
solution_paths:
type: array
items:
type: object
additionalProperties: true
recommended_stack:
type: array
items:
type: object
additionalProperties: true
nodes:
type: array
items:
type: object
additionalProperties: true
edges:
type: array
items:
type: object
additionalProperties: true
explanation:
type: array
items:
type: string
decomposition:
type: object
additionalProperties: true
confidence:
type: string
evidence:
$ref: '#/components/schemas/NormalizedEvidence'
caveats:
type: array
items:
type: string
confidence_reason:
type: string
source_fields:
type: array
items:
type: string
last_verified_at:
type:
- string
- 'null'
format: date-time
metadata:
type: object
additionalProperties: true
additionalProperties: true
NormalizedEvidence:
type: object
description: Normalized evidence package for agent citation and caveat handling.
properties:
classification:
type: object
additionalProperties: true
quality_signal_confidence:
$ref: '#/components/schemas/QualitySignalConfidence'
verification:
oneOf:
- $ref: '#/components/schemas/VerificationPackage'
- type: 'null'
source_fields:
type: array
items:
type: string
caveats:
type: array
items:
type: string
confidence_reason:
type: string
last_verified_at:
type:
- string
- 'null'
format: date-time
additionalProperties: true
VerificationSignal:
type: object
description: One project verification signal. observed and inferred are indexed evidence; not_run means the independent probe has not been executed.
required:
- status
- source
- evidence
properties:
status:
type: string
enum:
- verified
- observed
- inferred
- not_run
- not_applicable
- unknown
source:
type: string
enum:
- github_metadata
- git_top_heuristic
- git_top_runtime
evidence:
type: array
items:
type: string
additionalProperties: false
GrpRequest:
type: object
description: Graph Reasoning Protocol request for project planning, comparison, discovery, or stack composition.
required:
- goal
properties:
goal:
type: string
description: Natural-language project selection, comparison, planning, or stack-composition goal.
mode:
type: string
enum:
- plan
- compare
- find
- compose
default: plan
description: Reasoning mode. Defaults to plan when omitted.
constraints:
type: object
properties:
deploy:
type: array
items:
type: string
license:
type: string
complexity:
type: string
enum:
- low
- medium
- high
agent_ready:
type: boolean
language:
type: string
category:
type: string
additionalProperties: true
context:
type: object
properties:
previous_selected_projects:
type: array
items:
type: string
current_stack:
type: array
items:
type: string
additionalProperties: true
additionalProperties: true
VerificationPackage:
type: object
description: Structured verification coverage for project selection. It does not claim install, security, runtime, or MCP execution unless a signal is verified.
required:
- schema_version
- overall_status
- observed_at
- signals
- coverage
- next_steps
properties:
schema_version:
type: string
const: git-top.verification.v1
overall_status:
type: string
enum:
- complete
- partial
- unverified
observed_at:
type:
- string
- 'null'
format: date-time
signals:
type: object
required:
- activity
- license
- documentation
- runtime
- install
- security
- mcp
properties:
activity:
$ref: '#/components/schemas/VerificationSignal'
license:
$ref: '#/components/schemas/VerificationSignal'
documentation:
$ref: '#/components/schemas/VerificationSignal'
runtime:
$ref: '#/components/schemas/VerificationSignal'
install:
$ref: '#/components/schemas/VerificationSignal'
security:
$ref: '#/components/schemas/VerificationSignal'
mcp:
$ref: '#/components/schemas/VerificationSignal'
additionalProperties: false
coverage:
type: object
required:
- observed
- inferred
- not_run
- unknown
properties:
observed:
type: integer
minimum: 0
inferred:
type: integer
minimum: 0
not_run:
type: integer
minimum: 0
unknown:
type: integer
minimum: 0
additionalProperties: false
next_steps:
type: array
items:
type: string
additionalProperties: false
QualitySignalConfidence:
type: object
description: Completeness hints for GitHub-derived score inputs. Agents should avoid overclaiming partial or unknown signals.
properties:
stars_30d_delta:
type: string
enum:
- snapshot
- estimated
stars_30d_window_days:
type: integer
commits_30d:
type: string
enum:
- complete
- partial
- unknown
releases_180d:
type: string
enum:
- complete
- partial
- unknown
contributors_90d:
type: string
enum:
- complete
- partial
- unknown
additionalProperties: true
securitySchemes:
syncSecret:
type: http
scheme: bearer
description: Admin endpoints require the SYNC_SECRET bearer token.
feedbackSecret:
type: http
scheme: bearer
description: Optional FEEDBACK_SECRET. Without it, proposals are validated and fingerprinted but not persisted.