# Pilvio — how to use (mcp.ai)

Connect your Pilvio account and use 10 tools for developer tools straight from your AI agent. Connect with your own API key. Pilvio is a cloud service provider offering virtual machines, object storage, and full API support for resource management and automation.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_pilvio?ms=1787298840000`
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. `pilvio_check_active_campaigns`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/pilvio`
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/pilvio/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/pilvio/check/active/campaigns` — Tool to check for active campaigns. Use when you need to verify whether any campaigns are currently active.
- `POST https://api.mcp.ai/api/pilvio/get/user/info` — Tool to retrieve information about the authenticated user. Use when you need to fetch the current user's profile after authentication.
- `POST https://api.mcp.ai/api/pilvio/list/billing/accounts` — Tool to list billing accounts. Use when you need to fetch all billing accounts for management or reporting. Use after authenticating your Pilvio API key.
- `POST https://api.mcp.ai/api/pilvio/list/credit/cards` — Tool to list credit cards attached to a billing account. Use after confirming the billing account ID. Example: "Retrieve cards for billing_account_id 'ba_1234567890abcdef'."
  - body: { billing_account_id: string }
- `POST https://api.mcp.ai/api/pilvio/list/invoices` — Tool to retrieve a list of invoices. Use after authentication to fetch and filter invoices for a billing account.
  - body: { limit?: integer, offset?: integer, status?: string, date_to?: string, date_from?: string, billing_account_id: string }
- `POST https://api.mcp.ai/api/pilvio/list/locations` — Tool to retrieve the list of available data center locations. Use after authentication to see where you can deploy resources.
- `POST https://api.mcp.ai/api/pilvio/list/vm/resource/pools` — Tool to retrieve the list of available VM resource pools. Use after authentication to determine where you can provision VMs.
  - body: { page?: integer, page_size?: integer }
- `POST https://api.mcp.ai/api/pilvio/list/vm/snapshots` — Tool to list snapshots (replicas) of a specific VM. Use this to get all point-in-time snapshots or backups for a virtual machine.
  - body: { uuid: string, r_type?: string }
- `POST https://api.mcp.ai/api/pilvio/list/vms` — Tool to retrieve a list of all virtual machines. Use after authenticating to fetch your VMs.
  - body: { sort?: string, limit?: integer, offset?: integer, project_id?: string }
- `POST https://api.mcp.ai/api/pilvio/update/user/profile` — Tool to update the authenticated user's profile. Use after obtaining a valid API key when you need to modify profile details (e.g., change email or name).
  - body: { email?: string, username: string, last_name?: string, first_name?: string, phone_number?: string }

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

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