> ## Documentation Index > Fetch the complete documentation index at: https://www.greptile.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Tool Reference > Complete reference for all Greptile MCP server tools and parameters ## Tool Reference **4 tools for managing coding patterns and organizational standards** ### list\_custom\_context List organization custom context entries. **Parameters:** * `type` (optional): `CUSTOM_INSTRUCTION` or `PATTERN` * `greptileGenerated` (optional): Filter by Greptile-generated content * `limit` (optional): Maximum results (1-100, default 20) * `offset` (optional): Skip results for pagination (default 0) **Response:** ```json theme={} { "customContexts": [ { "id": "memory_9a7fe8b3-4cc6-4c1a-9c4c-8b7f3d2e1a6c", "type": "CUSTOM_INSTRUCTION", "body": "Use async/await instead of Promise.then() for better readability", "status": "ACTIVE", "scopes": {"AND": [{"operator": "MATCHES", "field": "filepath", "value": "**/*.js"}]}, "metadata": {}, "evidenceCount": 15, "commentsCount": 8, "createdAt": "2024-12-15T10:30:00Z" } ], "total": 20 } ``` ### get\_custom\_context Get detailed custom context information. **Parameters:** * `customContextId` (required): Custom context ID **Response:** ```json theme={} { "customContext": { "id": "ctx_123", "type": "CUSTOM_INSTRUCTION", "body": "Always use proper error handling", "status": "ACTIVE", "metadata": {}, "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. **Parameters:** * `query` (required): Search term * `limit` (optional): Maximum results (1-50, default 10) **Response:** ```json theme={} { "customContexts": [...], "query": "error handling", "total": 3 } ``` ### create\_custom\_context Create new custom context. **Parameters:** * `type` (optional): `CUSTOM_INSTRUCTION` or `PATTERN` (default `CUSTOM_INSTRUCTION`) * `body` (optional): Context content * `scopes` (optional): Boolean expression defining where context applies * `status` (optional): `ACTIVE`, `INACTIVE`, or `SUGGESTED` (default `ACTIVE`) * `metadata` (optional): Additional metadata object **Scopes Example:** ```json theme={} { "scopes": { "AND": [ { "operator": "MATCHES", "field": "filepath", "value": "**/*.js" } ] } } ``` **3 tools for accessing PR data and metadata across repositories** ### list\_merge\_requests / list\_pull\_requests List merge/pull requests. **Parameters:** * `name` (optional): Repository name (owner/repo format) * `remote` (optional): `github` or `gitlab` * `defaultBranch` (optional): Repository default branch * `remoteUrl` (optional): Self-hosted instance URL * `state` (optional): `open`, `closed`, or `merged` * `limit` (optional): Maximum results (1-100, default 20) * `offset` (optional): Skip results for pagination (default 0) **Note:** Repository parameters must be provided together (name, remote, defaultBranch) or omitted entirely. **Response:** ```json theme={} { "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 pull request information. **Parameters:** * `name` (required): Repository name (owner/repo format) * `remote` (required): `github` or `gitlab` * `defaultBranch` (required): Default branch * `remoteUrl` (optional): Self-hosted instance URL * `prNumber` (required): Pull request number **Response:** ```json theme={} { "mergeRequest": { "number": 45, "title": "Fix authentication bug", "description": "This PR fixes the auth issue...", "state": "open", "isDraft": false, "authorLogin": "developer", "branches": { "source": "feature/auth-fix", "target": "main" }, "stats": { "changedFiles": 3, "additions": 45, "deletions": 12 }, "labels": ["bug", "authentication"], "repository": { "name": "owner/repo", "url": "https://github.com/owner/repo" }, "greptileComments": [ { "commentId": "comment_789", "filePath": "src/auth.js", "createdAt": "2024-01-01T00:00:00Z" } ], "codeReviews": [ { "id": "review_456", "status": "COMPLETED", "createdAt": "2024-01-01T00:00:00Z", "completedAt": "2024-01-01T01:00:00Z" } ] } } ``` ### list\_merge\_request\_comments Get pull request comments. **Parameters:** * `name` (required): Repository name * `remote` (required): `github` or `gitlab` * `defaultBranch` (required): Default branch * `remoteUrl` (optional): Self-hosted instance URL * `prNumber` (required): Pull request number * `greptileGenerated` (optional): Filter Greptile comments * `addressed` (optional): Filter by addressed status **Response:** ```json theme={} { "comments": [ { "id": "comment_123", "commentId": "github_comment_456", "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 for promises" } } ], "repository": "owner/repo", "prNumber": 45, "total": 3 } ``` **3 tools for managing review lifecycle and results** ### list\_code\_reviews List code reviews. **Parameters:** * `name` (optional): Repository name * `remote` (optional): `github` or `gitlab` * `defaultBranch` (optional): Default branch * `remoteUrl` (optional): Self-hosted instance URL * `prNumber` (optional): Filter by pull request * `status` (optional): `PENDING`, `REVIEWING_FILES`, `GENERATING_SUMMARY`, `COMPLETED`, `FAILED`, `SKIPPED` * `limit` (optional): Maximum results (1-100, default 20) * `offset` (optional): Skip results for pagination (default 0) **Response:** ```json theme={} { "codeReviews": [ { "id": "review_123", "status": "COMPLETED", "createdAt": "2024-01-01T00:00:00Z", "completedAt": "2024-01-01T01:00:00Z", "metadata": {}, "mergeRequest": { "id": "mr_456", "prNumber": 45, "title": "Fix authentication bug", "sourceRepoUrl": "https://github.com/owner/repo", "repository": { "name": "owner/repo" } } } ], "total": 8 } ``` ### get\_code\_review Get detailed code review. **Parameters:** * `codeReviewId` (required): Code review ID **Response:** ```json theme={} { "codeReview": { "id": "review_123", "body": "## Summary\n\nThis PR fixes authentication...", "status": "COMPLETED", "createdAt": "2024-01-01T00:00:00Z", "completedAt": "2024-01-01T01:00:00Z", "metadata": {}, "mergeRequest": { "id": "mr_456", "prNumber": 45, "title": "Fix authentication bug", "sourceRepoUrl": "https://github.com/owner/repo", "description": "This PR fixes...", "authorLogin": "developer", "repository": { "id": "repo_789", "name": "owner/repo", "remote": "github", "remoteUrl": "https://github.com/owner/repo" } } } } ``` ### trigger\_code\_review Start new code review. **Parameters:** * `name` (required): Repository name * `remote` (required): `github` or `gitlab` * `defaultBranch` (required): Default branch * `branch` (optional): Working branch * `remoteUrl` (optional): Self-hosted instance URL * `prNumber` (required): Pull request number **Response:** ```json theme={} { "success": true, "message": "Code review triggered successfully", "repository": { "name": "owner/repo", "remote": "github" }, "prNumber": 45 } ``` **1 tool for searching and filtering review feedback** ### search\_greptile\_comments Search Greptile review comments. **Parameters:** * `query` (required): Search term * `limit` (optional): Maximum results (1-50, default 10) * `includeAddressed` (optional): Include resolved comments (default false) **Response:** ```json theme={} { "comments": [ { "id": "34567890", "commentId": "github_comment_987654321", "body": "Consider adding input validation to prevent potential security vulnerabilities. The user input should be sanitized before processing.", "authorLogin": "greptile-bot", "filePath": "src/auth/login.js", "lineStart": 45, "lineEnd": 47, "addressed": false, "createdAt": "2024-12-14T09:15:00Z", "mergeRequest": { "id": "12345", "prNumber": 156, "title": "Add user authentication endpoint", "sourceRepoUrl": "https://github.com/myorg/backend", "repository": { "name": "myorg/backend" } }, "linkedMemory": { "id": "memory_security_001", "type": "PATTERN", "body": "Always validate and sanitize user inputs to prevent security vulnerabilities" } } ], "query": "security", "total": 8 } ``` ## Error Responses Standard JSON-RPC error format: ```json theme={} { "jsonrpc": "2.0", "id": 1, "error": { "code": -32601, "message": "Method not found" } } ``` **Common Error Codes:** * `-32700`: Parse error * `-32600`: Invalid request * `-32601`: Method not found * `-32602`: Invalid parameters * `-32603`: Internal error * `-32000`: Server error (includes authentication and authorization failures)