The visual install guide for Claude, Cursor, ChatGPT and Manus is at getvamos.ai/mcp. This article is the reference: tools, limits, host behaviour, billing and troubleshooting.
The tools
Your AI client picks the right one from what you ask. You do not call them directly.
Tool | What it does | Spends credits |
| Runs a full Vamos turn and waits for it. Best for asks that finish inside 30 seconds, on hosts that hold a long connection. | Yes |
| Starts a turn in the background and returns a run id at once. The default on hosts that proxy MCP, because those proxies drop long synchronous calls. | Yes, on completion |
| Checks a run. Long-polls, so it returns as soon as the status changes. | No |
| Aborts a run so credits stop accruing. | No |
| Starts a new Vamos conversation and returns its id. | No |
| Lists your chats, so the AI can continue one rather than starting fresh. | No |
| Reads a chat's history. Also how to check whether a timed-out turn already finished. | No |
| Your remaining credits and plan. | No |
| Converts a doc's HTML into Markdown. | No |
| Whether the session is authenticated, and the sign-in URL if not. | No |
A completion has the same reach as the web app: video search, web search, profile and post analysis, comment pulls. It writes using your voice and your memories from My Brand.
What search covers: Instagram, TikTok and YouTube. Ask and it will also go after YouTube long-form and Facebook Ads. LinkedIn, X and Threads can be read from a link but cannot be searched.
The using-vamos skill
For Claude Code, install the using-vamos skill alongside the MCP. It teaches Claude how to call Vamos well rather than merely that it can.
Download it from getvamos.ai/skill, put it at ~/.claude/skills/using-vamos/SKILL.md, and restart Claude Code. It activates when you ask about social media.
What it adds over a bare MCP connection:
Continues an existing chat rather than starting a new one each time.
Picks the background path for anything substantial.
Folds a multi-part request into one completion instead of fanning out.
Passes Vamos's answer through rather than rewriting it.
On a timeout, checks whether the turn already finished before retrying.
The skill is Claude Code only for now.
What you cannot do
No file upload and no doc editing. Those stay in the web app.
No streaming. You get the full answer when Vamos finishes, which is anywhere from 30 seconds to about 10 minutes.
No raw tool results. You get Vamos's written answer. The underlying search results, transcripts and comment dumps are in the chat in the web app.
No switching workspace mid-session. The token is bound to the workspace you were in at sign-in. Switch in the app, then sign out and back in inside your client.
Retries are not free. Re-running a completion runs the whole job again and bills again. On a timeout, call get_messages first.
Host behaviour on long tasks
Client | Live progress | What you see |
Claude Code | Yes | Progress mid-call. Best experience, especially with the skill. |
Claude Desktop | Yes | Progress mid-call. |
Cursor | Minimal | Little until it is done. |
ChatGPT | No | Silent until the result returns. |
Manus and autonomous agents | Varies | May retry hard, and each retry bills. Cap retries at one. |
Codex | Partial | Depends on the version. |
On ChatGPT and Cursor, expect up to ten minutes of silence on heavy research. Break big requests into smaller ones.
Billing
MCP runs on the same credits as the web app and costs no extra. AUTO still applies.
Only chat_completion and chat_completion_start spend. Everything else is free. A background run bills when it completes even if you stop polling, so cancel rather than abandoning it.
Out of credits returns ERR_INSUFFICIENT_CREDITS. Top up in Settings, under Billing.
Troubleshooting
The AI is writing for the wrong workspace. The token is bound to the workspace from sign-in. Sign out of the Vamos MCP in your client and reconnect.
Nothing seems to be happening in Cursor. Cursor does not show tool progress. Give it ten minutes, then check your credit balance.
My agent is burning credits. Autonomous agents retry failed calls, and each retry re-runs the completion. Set a retry cap of one.
The skill will not activate. Check the path is exactly ~/.claude/skills/using-vamos/SKILL.md, restart, and ask something explicitly about social media.
The AI told me to open a dashboard page that does not exist. It hit an auth error and invented navigation. Ask it to call auth_status, which returns the real sign-in URL, or reconnect in your client's connector settings.
Can I revoke access? Sign out of the MCP server in your client, or ask us to revoke it server-side.
Does it work for a team? Each person authenticates with their own account. There is no shared key.
Which plan do I need? Any plan with credits.