Tools Reference

Complete reference for all tools provided by the Greptile MCP server.

This reference is sourced from Greptile’s official MCP documentation. Parameters are inputs you provide when calling a tool; responses are the data returned.

Tools by Category

Custom Context
Pull Requests
Code Reviews
Comments

4 tools for managing coding patterns and organizational standards

list_custom_context

List your organization’s custom context entries.

Input Parameters

Parameter	Type	Required	Description
`type`	string	No	`CUSTOM_INSTRUCTION` or `PATTERN`
`greptileGenerated`	boolean	No	Filter by Greptile-generated content
`limit`	number	No	Max results (1-100, default 20)
`offset`	number	No	Skip results for pagination

Response Format

{
  "customContexts": [
    {
      "id": "memory_9a7fe8b3-4cc6-4c1a-9c4c-8b7f3d2e1a6c",
      "type": "CUSTOM_INSTRUCTION",
      "body": "Use async/await instead of Promise.then()",
      "status": "ACTIVE",
      "scopes": {"AND": [{"operator": "MATCHES", "field": "filepath", "value": "**/*.js"}]},
      "evidenceCount": 15,
      "commentsCount": 8,
      "createdAt": "2024-12-15T10:30:00Z"
    }
  ],
  "total": 20
}

get_custom_context

Get detailed information about a specific custom context entry.

Input Parameters

Parameter	Type	Required	Description
`customContextId`	string	Yes	Custom context ID

Response Format

{
  "customContext": {
    "id": "ctx_123",
    "type": "CUSTOM_INSTRUCTION",
    "body": "Always use proper error handling",
    "status": "ACTIVE",
    "scopes": {"AND": []},
    "createdAt": "2024-01-01T00:00:00Z",
    "linkedComments": [
      {
        "id": "comment_456",
        "filePath": "src/utils.js",
        "mergeRequestId": "mr_789"
      }
    ]
  }
}

search_custom_context

Search custom context by content.

Input Parameters

Parameter	Type	Required	Description
`query`	string	Yes	Search term
`limit`	number	No	Max results (1-50, default 10)

Response Format

{
  "customContexts": [...],
  "query": "error handling",
  "total": 3
}

create_custom_context

Create a new custom context entry.

Input Parameters

Parameter	Type	Required	Description
`type`	string	No	`CUSTOM_INSTRUCTION` or `PATTERN` (default: `CUSTOM_INSTRUCTION`)
`body`	string	No	Context content
`scopes`	object	No	Where context applies (see format below)
`status`	string	No	`ACTIVE`, `INACTIVE`, or `SUGGESTED`
`metadata`	object	No	Additional metadata

Scopes Format:

{
  "scopes": {
    "AND": [
      {"operator": "MATCHES", "field": "filepath", "value": "**/*.js"}
    ]
  }
}

3 tools for accessing PR data and metadata

list_merge_requests / list_pull_requests

List merge/pull requests. Both tool names work identically.

Input Parameters

Parameter	Type	Required	Description
`name`	string	No*	Repository name (owner/repo)
`remote`	string	No*	`github` or `gitlab`
`defaultBranch`	string	No*	Repository default branch
`remoteUrl`	string	No	Self-hosted instance URL
`state`	string	No	`open`, `closed`, or `merged`
`limit`	number	No	Max results (1-100, default 20)
`offset`	number	No	Skip results for pagination

*Repository parameters (name, remote, defaultBranch) must be provided together or omitted entirely.

Response Format

{
  "mergeRequests": [
    {
      "id": "mr_123",
      "number": 45,
      "title": "Fix authentication bug",
      "state": "open",
      "isDraft": false,
      "authorLogin": "developer",
      "repository": {"name": "owner/repo", "remote": "github"},
      "stats": {"changedFiles": 3, "additions": 45, "deletions": 12},
      "commentsCount": 2,
      "reviewsCount": 1,
      "createdAt": "2024-01-01T00:00:00Z"
    }
  ],
  "total": 15
}

get_merge_request

Get detailed information about a specific PR.

Input Parameters

Parameter	Type	Required	Description
`name`	string	Yes	Repository name (owner/repo)
`remote`	string	Yes	`github` or `gitlab`
`defaultBranch`	string	Yes	Default branch
`prNumber`	number	Yes	Pull request number
`remoteUrl`	string	No	Self-hosted instance URL

Response Format

{
  "mergeRequest": {
    "number": 45,
    "title": "Fix authentication bug",
    "description": "...",
    "state": "open",
    "authorLogin": "developer",
    "branches": {"source": "feature/auth-fix", "target": "main"},
    "stats": {"changedFiles": 3, "additions": 45, "deletions": 12},
    "labels": ["bug"],
    "greptileComments": [...],
    "codeReviews": [...]
  }
}

list_merge_request_comments

Get comments for a specific PR.

Input Parameters

Parameter	Type	Required	Description
`name`	string	Yes	Repository name
`remote`	string	Yes	`github` or `gitlab`
`defaultBranch`	string	Yes	Default branch
`prNumber`	number	Yes	Pull request number
`greptileGenerated`	boolean	No	Filter Greptile comments only
`addressed`	boolean	No	Filter by addressed status
`remoteUrl`	string	No	Self-hosted instance URL

Response Format

{
  "comments": [
    {
      "id": "comment_123",
      "body": "Consider using async/await here",
      "authorLogin": "greptile-bot",
      "filePath": "src/utils.js",
      "lineStart": 45,
      "lineEnd": 47,
      "greptileGenerated": true,
      "addressed": false,
      "createdAt": "2024-01-01T00:00:00Z",
      "linkedMemory": {
        "id": "memory_789",
        "type": "CUSTOM_INSTRUCTION",
        "body": "Always use async/await"
      }
    }
  ],
  "total": 3
}

3 tools for managing review lifecycle

list_code_reviews

List code reviews.

Input Parameters

Parameter	Type	Required	Description
`name`	string	No	Repository name
`remote`	string	No	`github` or `gitlab`
`defaultBranch`	string	No	Default branch
`prNumber`	number	No	Filter by PR
`status`	string	No	`PENDING`, `REVIEWING_FILES`, `GENERATING_SUMMARY`, `COMPLETED`, `FAILED`, `SKIPPED`
`limit`	number	No	Max results (1-100, default 20)
`offset`	number	No	Skip results

Response Format

{
  "codeReviews": [
    {
      "id": "review_123",
      "status": "COMPLETED",
      "createdAt": "2024-01-01T00:00:00Z",
      "completedAt": "2024-01-01T01:00:00Z",
      "mergeRequest": {
        "prNumber": 45,
        "title": "Fix authentication bug",
        "repository": {"name": "owner/repo"}
      }
    }
  ],
  "total": 8
}

get_code_review

Get detailed code review information.

Input Parameters

Parameter	Type	Required	Description
`codeReviewId`	string	Yes	Code review ID

Response Format

{
  "codeReview": {
    "id": "review_123",
    "body": "## Summary\n\nThis PR fixes...",
    "status": "COMPLETED",
    "createdAt": "2024-01-01T00:00:00Z",
    "completedAt": "2024-01-01T01:00:00Z",
    "mergeRequest": {
      "prNumber": 45,
      "title": "Fix authentication bug",
      "repository": {"name": "owner/repo", "remote": "github"}
    }
  }
}

trigger_code_review

Start a new code review on a PR.

Input Parameters

Parameter	Type	Required	Description
`name`	string	Yes	Repository name
`remote`	string	Yes	`github` or `gitlab`
`defaultBranch`	string	Yes	Default branch
`prNumber`	number	Yes	Pull request number
`branch`	string	No	Working branch
`remoteUrl`	string	No	Self-hosted instance URL

Response Format

{
  "success": true,
  "message": "Code review triggered successfully",
  "repository": {"name": "owner/repo", "remote": "github"},
  "prNumber": 45
}

1 tool for searching review feedback

search_greptile_comments

Search across all Greptile review comments.

Input Parameters

Parameter	Type	Required	Description
`query`	string	Yes	Search term
`limit`	number	No	Max results (1-50, default 10)
`includeAddressed`	boolean	No	Include resolved comments (default: false)

Response Format

{
  "comments": [
    {
      "id": "34567890",
      "body": "Consider adding input validation...",
      "authorLogin": "greptile-bot",
      "filePath": "src/auth/login.js",
      "lineStart": 45,
      "lineEnd": 47,
      "addressed": false,
      "createdAt": "2024-12-14T09:15:00Z",
      "mergeRequest": {
        "prNumber": 156,
        "title": "Add user authentication endpoint",
        "repository": {"name": "myorg/backend"}
      },
      "linkedMemory": {
        "id": "memory_security_001",
        "type": "PATTERN",
        "body": "Always validate and sanitize user inputs"
      }
    }
  ],
  "query": "security",
  "total": 8
}

Error Responses

All tools return errors in standard JSON-RPC format:

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32601,
    "message": "Method not found"
  }
}

Code	Meaning
`-32700`	Parse error
`-32600`	Invalid request
`-32601`	Method not found
`-32602`	Invalid parameters
`-32603`	Internal error (includes auth failures)

Quick Reference

Tool	Category	Purpose
`list_custom_context`	Custom Context	List all coding patterns
`get_custom_context`	Custom Context	Get pattern details
`search_custom_context`	Custom Context	Search patterns
`create_custom_context`	Custom Context	Create new pattern
`list_merge_requests`	Pull Requests	List PRs
`get_merge_request`	Pull Requests	Get PR details
`list_merge_request_comments`	Pull Requests	Get PR comments
`list_code_reviews`	Code Reviews	List reviews
`get_code_review`	Code Reviews	Get review details
`trigger_code_review`	Code Reviews	Start new review
`search_greptile_comments`	Comments	Search feedback

Getting Started

Code Review

Self-Hosting

Account

API Reference

How Greptile Works

Tools by Category

list_custom_context

get_custom_context

search_custom_context

create_custom_context

list_merge_requests / list_pull_requests

get_merge_request

list_merge_request_comments

list_code_reviews

get_code_review

trigger_code_review

search_greptile_comments

Error Responses

Quick Reference

Getting Started

Code Review

Self-Hosting

Account

API Reference

How Greptile Works

​Tools by Category

​list_custom_context

​get_custom_context

​search_custom_context

​create_custom_context

​list_merge_requests / list_pull_requests

​get_merge_request

​list_merge_request_comments

​list_code_reviews

​get_code_review

​trigger_code_review

​search_greptile_comments

​Error Responses

​Quick Reference

Tools by Category

list_custom_context

get_custom_context

search_custom_context

create_custom_context

list_merge_requests / list_pull_requests

get_merge_request

list_merge_request_comments

list_code_reviews

get_code_review

trigger_code_review

search_greptile_comments

Error Responses

Quick Reference