Grepr GitHub MCP Integration API
The GitHub MCP Integration API from Grepr — 3 operation(s) for github mcp integration.
The GitHub MCP Integration API from Grepr — 3 operation(s) for github mcp integration.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/grepr:grepr-github-mcp-integration-api"
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.
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: 3.2.0
info:
title: Grepr GitHub MCP Integration API
version: 1.0.0
description: 'Operations tagged GitHub MCP Integration across 2 of this provider''s published API definitions: grepr-openapi.json, grepr.json. Each path carries the servers of the definition it was published in.'
tags:
- name: GitHub MCP Integration
paths:
/v1/integrations/github-mcp:
get:
description: Get all GitHub MCP server integrations for your organization. This will contain masked tokens if present.
operationId: list_10
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/ItemsCollectionReadGithubMcp'
description: Integrations retrieved successfully
'401':
description: Unauthorized
security:
- grepr-api-key: []
- grepr-oidc: []
summary: List all GitHub MCP integrations
tags:
- GitHub MCP Integration
post:
description: Creates an integration to connect to a GitHub MCP server.
operationId: create_8
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/WriteGithubMcp'
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/ReadGithubMcp'
description: Integration created successfully
'401':
description: Unauthorized
'409':
content:
application/json:
schema:
$ref: '#/components/schemas/ReadGithubMcp'
description: Integration already exists.
security:
- grepr-api-key: []
- grepr-oidc: []
summary: Create a GitHub MCP integration
tags:
- GitHub MCP Integration
/v1/integrations/github-mcp/{id}:
delete:
description: Deletes a GitHub MCP integration. This will delete the associated token as well. No-op if already deleted.
operationId: delete_8
parameters:
- in: path
name: id
required: true
schema:
type: string
responses:
'204':
description: Integration deleted successfully
'401':
description: Unauthorized
security:
- grepr-api-key: []
- grepr-oidc: []
summary: Delete a GitHub MCP integration
tags:
- GitHub MCP Integration
get:
description: Get a GitHub MCP integration by ID.
operationId: get_10
parameters:
- in: path
name: id
required: true
schema:
type: string
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/ReadGithubMcp'
description: Integration retrieved successfully
'401':
description: Unauthorized
'404':
description: Integration not found.
security:
- grepr-api-key: []
- grepr-oidc: []
summary: Get a GitHub MCP integration
tags:
- GitHub MCP Integration
put:
description: Updates a GitHub MCP integration. The version should be increased by one for every new update in order for the write to succeed. Otherwise, a '409 Conflict' will be returned.
operationId: update_6
parameters:
- in: path
name: id
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/WriteGithubMcp'
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/ReadGithubMcp'
description: Integration updated successfully
'401':
description: Unauthorized
'404':
description: Integration not found.
'409':
description: Integration was modified or deleted concurrently.
security:
- grepr-api-key: []
- grepr-oidc: []
summary: Update a GitHub MCP integration
tags:
- GitHub MCP Integration
/v1/integrations/github-mcp/{id}/api-key:
put:
description: Creates a token for a GitHub MCP integration if it doesn't exist and updates it otherwise. If the token is updated while the integration is being used by a pipeline, the new token will be picked at pipeline restart, rescaling or an update.
operationId: upsertApiKey_4
parameters:
- in: path
name: id
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SecretApi'
responses:
'204':
description: Token upserted successfully.
'401':
description: Unauthorized
'404':
description: Integration not found.
security:
- grepr-api-key: []
- grepr-oidc: []
summary: Creates or updates a GitHub MCP integration token
tags:
- GitHub MCP Integration
components:
schemas:
SecretApi:
description: Secret wrapper for API responses
properties:
secret:
description: The secret value
type: string
required:
- secret
type: object
ReadGithubMcp:
properties:
createdAt:
description: Timestamp when the integration was created.
format: date-time
readOnly: true
type: string
id:
description: The integration id
type: string
jobIds:
description: List of job IDs associated with the integration.
items:
description: List of job IDs associated with the integration.
type: string
type: array
uniqueItems: true
name:
description: Name of the integration.
example: my_integration
pattern: '[a-zA-Z0-9 _-]{1,128}'
type: string
organizationId:
description: Organization ID of the integration.
type: string
payload:
$ref: '#/components/schemas/GithubMcp'
teamIds:
description: The team IDs that this integration is associated with.
items:
description: The team IDs that this integration is associated with.
type: string
type: array
uniqueItems: true
type:
description: The type of the integration. This is used to determine the payload type.
enum:
- github-mcp
type: string
updatedAt:
description: Timestamp when the integration was last updated.
format: date-time
readOnly: true
type: string
version:
description: Version of the integration. Should be increased by one for every new update in order for the write to succeed. Otherwise, a '409 Conflict' will be returned.
example: 0
format: int32
minimum: 0
type: integer
required:
- createdAt
- id
- jobIds
- name
- organizationId
- payload
- type
- updatedAt
- version
type: object
ItemsCollectionReadGithubMcp:
properties:
items:
default: []
items:
$ref: '#/components/schemas/ReadGithubMcp'
type: array
type: object
GithubMcp:
description: The payload containing integration data.
properties:
apiKey:
description: Masked API key for the MCP server.
readOnly: true
type: string
serverUrl:
description: MCP server endpoint URL.
example: https://mcp.notion.so/v1
type: string
validateKeysOnSave:
default: true
description: Indicates whether to validate the API key when saving.
example: true
type: boolean
required:
- serverUrl
type: object
x-type:
type: github-mcp
WriteGithubMcp:
properties:
name:
description: Name of the integration.
example: my_integration
pattern: '[a-zA-Z0-9 _-]{1,128}'
type: string
payload:
$ref: '#/components/schemas/GithubMcp'
teamIds:
default: []
description: The team IDs that this integration is associated with.
items:
description: The team IDs that this integration is associated with.
type: string
type: array
uniqueItems: true
type:
description: The type of the integration. This is used to determine the payload type.
enum:
- github-mcp
type: string
version:
description: Version of the integration. Should be increased by one for every new update in order for the write to succeed. Otherwise, a '409 Conflict' will be returned.
example: 0
format: int32
minimum: 0
type: integer
required:
- name
- payload
- type
- version
type: object
securitySchemes:
grepr-api-key:
in: header
name: GREPR-API-KEY
type: apiKey
grepr-oidc:
bearerFormat: JWT
openIdConnectUrl: https://grepr-prod.us.auth0.com/.well-known/openid-configuration
type: openIdConnect
x-refined-from:
- grepr-openapi.json
- grepr.json
x-tagGroups:
- name: Integrations
tags:
- Grepr-hosted Data Warehouse Integration
- External S3 Data Warehouse Integration
- Datadog Integration
- New Relic Integration
- Splunk Integration
- Sumo Logic Integration
- OpenTelemetry Integration
- name: Pipelines
tags:
- Jobs
- Templates
- Datasets
- Status Metrics
- External Triggers
- Job Actions
- Triggers
- name: Pipeline Components
tags:
- Operations
- Transforms
- Sources
- Sinks
- name: Administration
tags:
- Users
- Teams
- Roles
- Permission
- Invitations
- Activity Logs
- name: Organization
tags:
- Organizations
- Access Configuration
- Grepr API Key
- Service Accounts
- Signup
- name: Query & Analysis
tags:
- Job Anomalies
- Grok Parsing
- Query Parsing
- Validation
- name: System
tags:
- Manifest