# Appveyor — how to use (mcp.ai)

Connect your Appveyor account and use 14 tools for developer tools straight from your AI agent. Connect with your own API key. AppVeyor is a hosted continuous integration service for building and deploying applications.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_appveyor?ms=1787291280000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `appveyor_delete_build`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/appveyor`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/appveyor/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/appveyor/delete/build` — Tool to delete a build by ID. Use when you need to remove a build from AppVeyor. The API returns 204 No Content on successful deletion.
  - body: { buildId: integer }
- `POST https://api.mcp.ai/api/appveyor/download/build/log` — Tool to download the build log for a specific job. Use when you need to retrieve the log output from a completed or running build job.
  - body: { jobId: string }
- `POST https://api.mcp.ai/api/appveyor/get/build/artifacts` — Tool to get the list of artifacts for a specific build job. Use when you need to retrieve artifacts after a job completes.
  - body: { jobId: string }
- `POST https://api.mcp.ai/api/appveyor/get/build/by/version` — Tool to get a specific project build by version number. Use when you need to retrieve detailed information about a build using its version identifier.
  - body: { accountName: string, projectSlug: string, buildVersion: string }
- `POST https://api.mcp.ai/api/appveyor/get/environments` — Tool to get a list of all deployment environments. Use when you need to enumerate available environments before creating deployments.
- `POST https://api.mcp.ai/api/appveyor/get/project/branch/status/badge` — Tool to get a project branch status badge image. Returns a PNG or SVG badge image showing the build status for a specific project branch.
  - body: { svg?: boolean, retina?: boolean, buildBranch: string, failingText?: string, passingText?: string, pendingText?: string, statusBadgeId: string }
- `POST https://api.mcp.ai/api/appveyor/get/project/status/badge` — Tool to get project status badge image. Use when you need to retrieve the status badge for displaying project build status.
  - body: { svg?: boolean, retina?: boolean, failingText?: string, passingText?: string, pendingText?: string, statusBadgeId: string }
- `POST https://api.mcp.ai/api/appveyor/get/projects` — Tool to get a list of all projects for the authenticated account. Use after authentication to enumerate available projects.
- `POST https://api.mcp.ai/api/appveyor/get/public/project/status/badge` — Tool to get status badge image for a project with a public repository. Use when you need to retrieve a build status badge for display or documentation purposes.
  - body: { svg?: boolean, branch?: string, retina?: boolean, repoSlug: string, failingText?: string, passingText?: string, pendingText?: string, repoAccountName: string, badgeRepoProvider: string }
- `POST https://api.mcp.ai/api/appveyor/get/role` — Tool to retrieve details of a specific role. Use when you need to inspect permissions and metadata of a role by ID.
  - body: { role_id: integer }
- `POST https://api.mcp.ai/api/appveyor/get/roles` — Tool to retrieve all roles in the account. Use when you need to enumerate available roles before assigning permissions.
- `POST https://api.mcp.ai/api/appveyor/get/user/invitations` — Tool to retrieve all pending user invitations in the account. Use when you need to list all outstanding invitations sent to potential team members.
- `POST https://api.mcp.ai/api/appveyor/get/users` — Tool to retrieve all users in the account. Use when you need to list all team users in your AppVeyor account.
- `POST https://api.mcp.ai/api/appveyor/list/collaborators` — Tool to retrieve all collaborators in the account. Use when you need to list all team collaborators in your AppVeyor account.

## Example prompts
- "What can I do in Appveyor?"
- "Show me a summary of my Appveyor account"

## More
- Page: https://mcp.ai/appveyor
- Agent spec (llms.txt): https://mcp.ai/appveyor/llms.txt
- Postman collection: https://mcp.ai/appveyor/postman.json