Skip to content
Scalekit Docs
Talk to an EngineerDashboard

Greptile MCP connector

OAuth2.1/DCRDeveloper ToolsSearchAI

AI-powered code search and understanding API that indexes GitHub and GitLab repositories, enabling natural language queries over codebases.

Greptile MCP connector

  1. Install the SDK

    Section titled “Install the SDK”
    Terminal window
    npm install @scalekit-sdk/node

    Full SDK reference: Node.js | Python

  2. Set your credentials

    Section titled “Set your credentials”

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>

  3. Authorize and make your first call

    Section titled “Authorize and make your first call”
    quickstart.ts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    

    const scalekit = new ScalekitClient(
      process.env.SCALEKIT_ENV_URL,
      process.env.SCALEKIT_CLIENT_ID,
      process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    

    const connector = 'greptilmcp'
    const identifier = 'user_123'
    

    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Greptile MCP:', link)
    process.stdout.write('Press Enter after authorizing...')
    await new Promise(r => process.stdin.once('data', r))
    

    // Make your first call
    const result = await actions.executeTool({
      connector,
      identifier,
      toolName: 'greptilmcp_list_code_reviews',
      toolInput: {},
    })
    console.log(result)

What you can do

Section titled “What you can do”

Connect this agent connector to let your agent:

  • Review trigger code — Trigger a Greptile code review for a pull request
  • Search greptile comments, custom context — Search Greptile review comments across all merge requests using text search
  • List pull requests, merge requests, merge request comments — List pull requests with optional filtering by repository, branch, author, and state
  • Get merge request, custom context, code review — Get detailed merge request information including metadata, statistics, Greptile comments, and review analysis
  • Create custom context — Create a new custom context for an organization to guide Greptile’s code review behavior

Tool list

Section titled “Tool list”

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

greptilmcp_create_custom_context#Create a new custom context for an organization to guide Greptile's code review behavior.5 params

Create a new custom context for an organization to guide Greptile's code review behavior.

NameTypeRequiredDescription
bodystringoptionalThe content of the custom context instruction or pattern.
metadataobjectoptionalAdditional metadata to associate with the custom context.
scopesobjectoptionalScope configuration for where this custom context applies.
statusstringoptionalThe initial status of the custom context: ACTIVE, INACTIVE, or SUGGESTED. Defaults to ACTIVE.
typestringoptionalThe type of custom context: CUSTOM_INSTRUCTION or PATTERN. Defaults to CUSTOM_INSTRUCTION.
greptilmcp_get_code_review#Get detailed code review information including status, comments, and analysis results.1 param

Get detailed code review information including status, comments, and analysis results.

NameTypeRequiredDescription
codeReviewIdstringrequiredThe unique identifier of the code review to retrieve.
greptilmcp_get_custom_context#Get detailed custom context information including evidence and linked comments.1 param

Get detailed custom context information including evidence and linked comments.

NameTypeRequiredDescription
customContextIdstringrequiredThe unique identifier of the custom context to retrieve.
greptilmcp_get_merge_request#Get detailed merge request information including metadata, statistics, Greptile comments, and review analysis.5 params

Get detailed merge request information including metadata, statistics, Greptile comments, and review analysis.

NameTypeRequiredDescription
defaultBranchstringrequiredThe default branch of the repository.
namestringrequiredThe repository name (e.g. owner/repo).
prNumbernumberrequiredThe pull request or merge request number.
remotestringrequiredThe git hosting provider: github, gitlab, azure, or bitbucket.
remoteUrlstringoptionalThe remote URL of the repository.
greptilmcp_list_code_reviews#List code reviews with optional filtering by repository, PR number, and review status.8 params

List code reviews with optional filtering by repository, PR number, and review status.

NameTypeRequiredDescription
defaultBranchstringoptionalFilter by the repository's default branch.
limitnumberoptionalMaximum number of results to return (1-100). Defaults to 20.
namestringoptionalFilter by repository name (e.g. owner/repo).
offsetnumberoptionalNumber of results to skip for pagination. Defaults to 0.
prNumbernumberoptionalFilter by pull request number.
remotestringoptionalFilter by git hosting provider.
remoteUrlstringoptionalFilter by the remote URL of the repository.
statusstringoptionalFilter by code review status.
greptilmcp_list_custom_context#List organization custom context with optional filtering by type and generation source.4 params

List organization custom context with optional filtering by type and generation source.

NameTypeRequiredDescription
greptileGeneratedbooleanoptionalFilter by whether the context was generated by Greptile.
limitnumberoptionalMaximum number of results to return (1-100). Defaults to 20.
offsetnumberoptionalNumber of results to skip for pagination. Defaults to 0.
typestringoptionalFilter by context type: CUSTOM_INSTRUCTION or PATTERN.
greptilmcp_list_merge_request_comments#Get all comments for a pull request or merge request, with optional filtering by generation source, addressed status, and date range.9 params

Get all comments for a pull request or merge request, with optional filtering by generation source, addressed status, and date range.

NameTypeRequiredDescription
defaultBranchstringrequiredThe default branch of the repository.
namestringrequiredThe repository name (e.g. owner/repo).
prNumbernumberrequiredThe pull request or merge request number.
remotestringrequiredThe git hosting provider: github, gitlab, azure, or bitbucket.
addressedbooleanoptionalFilter by whether the comment has been addressed.
createdAfterstringoptionalFilter comments created after this ISO 8601 datetime.
createdBeforestringoptionalFilter comments created before this ISO 8601 datetime.
greptileGeneratedbooleanoptionalFilter by whether the comment was generated by Greptile.
remoteUrlstringoptionalThe remote URL of the repository.
greptilmcp_list_merge_requests#List merge requests/PRs with optional filtering by repository, branch, author, and state.9 params

List merge requests/PRs with optional filtering by repository, branch, author, and state.

NameTypeRequiredDescription
authorLoginstringoptionalFilter by the author's login username.
defaultBranchstringoptionalFilter by the repository's default branch.
limitnumberoptionalMaximum number of results to return (1-100). Defaults to 20.
namestringoptionalFilter by repository name.
offsetnumberoptionalNumber of results to skip for pagination. Defaults to 0.
remotestringoptionalFilter by git hosting provider.
remoteUrlstringoptionalFilter by the remote URL of the repository.
sourceBranchstringoptionalFilter by the source branch of the merge request.
statestringoptionalFilter by merge request state: open, closed, or merged.
greptilmcp_list_pull_requests#List pull requests with optional filtering by repository, branch, author, and state. Alias for list_merge_requests.9 params

List pull requests with optional filtering by repository, branch, author, and state. Alias for list_merge_requests.

NameTypeRequiredDescription
authorLoginstringoptionalFilter by the author's login username.
defaultBranchstringoptionalFilter by the repository's default branch.
limitnumberoptionalMaximum number of results to return (1-100). Defaults to 20.
namestringoptionalFilter by repository name.
offsetnumberoptionalNumber of results to skip for pagination. Defaults to 0.
remotestringoptionalFilter by git hosting provider.
remoteUrlstringoptionalFilter by the remote URL of the repository.
sourceBranchstringoptionalFilter by the source branch of the pull request.
statestringoptionalFilter by pull request state: open, closed, or merged.
greptilmcp_search_custom_context#Search custom context by content using text search.3 params

Search custom context by content using text search.

NameTypeRequiredDescription
querystringrequiredText query to search custom context content.
limitnumberoptionalMaximum number of results to return (1-50). Defaults to 10.
offsetnumberoptionalNumber of results to skip for pagination. Defaults to 0.
greptilmcp_search_greptile_comments#Search Greptile review comments across all merge requests using text search.4 params

Search Greptile review comments across all merge requests using text search.

NameTypeRequiredDescription
querystringrequiredText query to search Greptile review comments.
createdAfterstringoptionalFilter comments created after this ISO 8601 datetime.
includeAddressedbooleanoptionalWhether to include already-addressed comments in results. Defaults to false.
limitnumberoptionalMaximum number of results to return (1-50). Defaults to 10.
greptilmcp_trigger_code_review#Trigger a Greptile code review for a pull request. Supported on GitHub and GitLab only.6 params

Trigger a Greptile code review for a pull request. Supported on GitHub and GitLab only.

NameTypeRequiredDescription
namestringrequiredThe repository name (e.g. owner/repo).
prNumbernumberrequiredThe pull request number to trigger a code review for.
remotestringrequiredThe git hosting provider. Only github and gitlab are supported.
branchstringoptionalThe source branch of the pull request to review.
defaultBranchstringoptionalThe default branch of the repository.
remoteUrlstringoptionalThe remote URL of the repository.