VAP
- python
2
GitHub Stars
python
Language
4 months ago
First Indexed
2 months ago
Catalog Refreshed
Documentation & install
Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.
VAP Media provides a unified MCP server that lets AI agents generate images, videos, and music with built-in cost controls and deterministic outputs. It exposes media generation as portable, pay‑per‑use tools that work across MCP‑compatible clients, making it easy to integrate generation capabilities into agent workflows while keeping budgeting and ownership clear.
How to use
You connect your MCP client to VAP to request media generation from Flux, Veo, and Suno models with guaranteed budgeting. Before you generate, you deposit funds to enable transactions, then issue generation tasks through your MCP client. Each task reserves the exact cost beforehand, executes with deterministic results, and delivers publishable media through a streamlined production pipeline.
How to install
Prerequisites: you need a compatible MCP client, and internet access to reach the VAP MCP endpoint. Ensure you have a valid API key to authorize requests.
Step 1. Create your MCP agent and obtain an API key from the edge dashboard or the API flow.
Step 2. Deposit funds to enable generation. Start with at least $1 to unlock generation capabilities.
Step 3. Configure your MCP client to connect to the VAP MCP server. You can use the remote HTTP endpoint shown below or run a local proxy if your environment requires headers handling.
{
"mcpServers": {
"vap": {
"type": "http",
"url": "https://api.vapagent.com/mcp",
"args": []
}
}
}
Additional setup options
If you prefer a local proxy to manage headers or run in environments without header support, you can run a local Python proxy. Use the command and arguments shown here to start the proxy and provide your API key.
{
"mcpServers": {
"vap": {
"command": "python",
"args": ["/path/to/mcp/vap_mcp_proxy.py"],
"env": {
"VAP_API_KEY": "your_api_key"
}
}
}
}
How to run typical tasks
Once connected, you can request media generation through your MCP client by selecting the media type and providing a textual prompt. You will see a pre‑commit pricing message, followed by reservation, execution, and delivery messages. If a task fails, you receive a full refund and a clear error message. Your agent simply receives the final media or a URL to the delivered asset.
Presets
VAP provides ready‑to‑use presets to streamline production and SEO workflows. Examples include image.basic for photos, video.basic for cinematic clips, music.basic for original tracks, streaming_campaign for campaigns, and full_production for end‑to‑end production with SEO.
OAuth 2.1 enterprise authentication
For organizations using enterprise authentication, VAP supports OAuth 2.1 M2M to connect your identity provider to VAP without embedding API keys in clients. This enables single sign‑on, automatic token rotation, and auditable events.
SDK usage and endpoints
You can access image, video, and music generation through the SDK or REST endpoints. The SDKs provide simple methods to generate media, check costs, and monitor task status. Endpoints include task creation, task status retrieval, balance checks, and OAuth linkage for enterprise use.
The four guarantees
Pre‑commit pricing: you know the exact cost before execution. Budget enforcement: you can set a maximum budget and the system will reject tasks that would exceed it. Failure ownership: every task has a defined owner and an address for failures. Deterministic production quality: outputs are normalized to broadcast standards for consistent, publishable media.
Notes on usage and endpoints
Key API endpoints include creating tasks, retrieving task status, checking balance, and linking OAuth clients for enterprise use. A full API reference is available to guide integration and automation.
Available tools
generate_image
Create photorealistic images from text prompts using Flux2 Pro models.
generate_video
Create cinematic videos from text prompts using Veo 3.1 models.
generate_music
Create original music from text prompts using Suno V5 models.
estimate_cost
Preview the estimated cost before starting a generation task.
check_balance
Check your current account balance and remaining credits.
get_task
Retrieve the status and results of a running or completed task.
list_tasks
List recent tasks for quick monitoring.