Back to Home

API Reference

Complete documentation for all 7 MCP tools. Each tool provides read-only access to your GitHub, Vercel, or Google Drive data.

GitHub Tools

autonomy/review_pr

Fetch PR details, diff, and files changed for AI review. Returns comprehensive PR data including title, description, files changed, and diff content.

Parameters

repostringrequired

Repository in format 'owner/repo'

prnumberrequired

Pull request number

Example

Request:

{
  "repo": "yourusername/autonomy",
  "pr": 42
}

Response:

{
  "success": true,
  "data": {
    "pr": {
      "number": 42,
      "title": "Add feature X",
      "body": "This PR adds feature X...",
      "state": "open",
      "author": "johndoe",
      "additions": 150,
      "deletions": 30,
      "changed_files": 5
    },
    "files": [
      {
        "filename": "src/app.ts",
        "status": "modified",
        "additions": 50,
        "deletions": 10,
        "changes": 60
      }
    ],
    "diff": "diff --git a/src/app.ts..."
  }
}

Common Use Cases

  • Automated code review and quality checks
  • PR impact analysis and risk assessment
  • Documentation generation from code changes
  • Merge conflict detection before review

autonomy/list_prs

List pull requests for a repository with optional state filter (open/closed/all).

Parameters

repostringrequired

Repository in format 'owner/repo'

statestring (enum)optional

Filter by state: open, closed, or all

Default: open

Example

Request:

{
  "repo": "yourusername/autonomy",
  "state": "open"
}

Response:

{
  "success": true,
  "data": [
    {
      "number": 42,
      "title": "Add feature X",
      "state": "open",
      "author": "johndoe",
      "created_at": "2025-01-15T10:00:00Z",
      "updated_at": "2025-01-20T14:30:00Z"
    },
    {
      "number": 41,
      "title": "Fix bug Y",
      "state": "open",
      "author": "janedoe",
      "created_at": "2025-01-14T08:00:00Z",
      "updated_at": "2025-01-19T16:00:00Z"
    }
  ]
}

Common Use Cases

  • PR dashboard and team workflow visibility
  • Stale PR detection and cleanup
  • Release notes generation from merged PRs
  • Team velocity and contribution metrics

Vercel Tools

autonomy/deploy_status

Get latest deployment status from Vercel. Returns deployment state, build logs, and performance metrics.

Parameters

projectNamestringoptional

Vercel project name

Default: autonomy-portal

limitnumberoptional

Number of deployments to fetch (max 100)

Default: 10

Example

Request:

{
  "projectName": "autonomy-portal",
  "limit": 5
}

Response:

{
  "success": true,
  "data": {
    "latest": {
      "id": "dpl_abc123",
      "url": "autonomy-portal-xyz.vercel.app",
      "state": "READY",
      "ready": 1737300000000,
      "created": 1737299000000,
      "creator": "johndoe",
      "target": "production",
      "git": {
        "ref": "main",
        "sha": "abc123",
        "message": "feat: add new feature",
        "author": "John Doe"
      }
    },
    "recent": [
      {
        "id": "dpl_abc123",
        "url": "autonomy-portal-xyz.vercel.app",
        "state": "READY",
        "ready": 1737300000000,
        "created": 1737299000000,
        "target": "production"
      }
    ]
  }
}

Common Use Cases

  • Deployment monitoring and alerting
  • Build failure diagnostics
  • Production readiness validation
  • CI/CD pipeline integration

autonomy/get_deployment

Get detailed information about a specific Vercel deployment including build logs and errors.

Parameters

deploymentIdstringrequired

Vercel deployment ID

Example

Request:

{
  "deploymentId": "dpl_abc123"
}

Response:

{
  "success": true,
  "data": {
    "deployment": {
      "id": "dpl_abc123",
      "url": "autonomy-portal-xyz.vercel.app",
      "state": "READY",
      "created": 1737299000000,
      "ready": 1737300000000
    },
    "events": [
      {
        "type": "build-start",
        "timestamp": 1737299000000,
        "text": "Building application..."
      },
      {
        "type": "build-complete",
        "timestamp": 1737300000000,
        "text": "Build completed successfully"
      }
    ]
  }
}

Common Use Cases

  • Build log analysis for debugging
  • Performance metrics extraction
  • Error trace investigation
  • Deployment rollback decision making

Google Drive Tools

autonomy/report_summary

Fetch and summarize recent reports from Google Drive. Returns list of reports from the specified folder within the given timeframe.

Parameters

folderIdstringoptional

Google Drive folder ID

daysBacknumberoptional

Number of days back to fetch reports (max 365)

Default: 7

Example

Request:

{
  "folderId": "1aBcDeFgHiJkLmNoPqRsTuVwXyZ",
  "daysBack": 7
}

Response:

{
  "success": true,
  "data": {
    "summary": {
      "totalFiles": 5,
      "dateRange": {
        "from": "2025-01-13T00:00:00Z",
        "to": "2025-01-20T00:00:00Z"
      },
      "folderId": "1aBcDeFgHiJkLmNoPqRsTuVwXyZ"
    },
    "files": [
      {
        "id": "1xYz",
        "name": "Q1 2025 Report.docx",
        "mimeType": "application/vnd.google-apps.document",
        "createdTime": "2025-01-15T10:00:00Z",
        "modifiedTime": "2025-01-18T14:30:00Z",
        "webViewLink": "https://docs.google.com/document/d/...",
        "owner": "Jane Doe"
      }
    ]
  }
}

Common Use Cases

  • Weekly report aggregation and summaries
  • Document discovery for team collaboration
  • Automated report distribution
  • Compliance audit trail generation

autonomy/get_file

Get file content or metadata from Google Drive. For Google Docs/Sheets, specify mimeType for export format.

Parameters

fileIdstringrequired

Google Drive file ID

mimeTypestringoptional

MIME type for export (e.g., 'text/plain', 'application/pdf')

Example

Request:

{
  "fileId": "1xYz",
  "mimeType": "text/plain"
}

Response:

{
  "success": true,
  "data": {
    "metadata": {
      "id": "1xYz",
      "name": "Q1 2025 Report.docx",
      "mimeType": "application/vnd.google-apps.document",
      "size": "45678",
      "createdTime": "2025-01-15T10:00:00Z",
      "modifiedTime": "2025-01-18T14:30:00Z",
      "webViewLink": "https://docs.google.com/document/d/..."
    },
    "content": "# Q1 2025 Report\n\nExecutive Summary..."
  }
}

Common Use Cases

  • Document content extraction for AI analysis
  • Automated report parsing and data extraction
  • Content migration and backup
  • Search indexing and knowledge base creation

autonomy/list_files

List files from Google Drive with optional folder and query filters.

Parameters

folderIdstringoptional

Folder ID to list files from

querystringoptional

Search query for file names

limitnumberoptional

Number of files to return (max 100)

Default: 10

Example

Request:

{
  "folderId": "1aBcDeFgHiJkLmNoPqRsTuVwXyZ",
  "query": "report",
  "limit": 10
}

Response:

{
  "success": true,
  "data": {
    "files": [
      {
        "id": "1xYz",
        "name": "Q1 2025 Report.docx",
        "mimeType": "application/vnd.google-apps.document",
        "createdTime": "2025-01-15T10:00:00Z",
        "modifiedTime": "2025-01-18T14:30:00Z",
        "webViewLink": "https://docs.google.com/document/d/..."
      }
    ]
  }
}

Common Use Cases

  • File organization and cleanup
  • Search and discovery across team drives
  • Duplicate file detection
  • Automated file tagging and categorization

Ready to get started?

Install the MCP server and start using these tools in Claude Desktop or ChatGPT.

Installation GuideView Examples