Use Intentos from your AI assistant with MCP

The Model Context Protocol server lets AI assistants, Claude Desktop, Claude Code, Cursor, use IntentOS through natural language. Ask an assistant to “generate a 16:9 image of…” or “how many credits do I have left?” and it calls your account.

Research tools (scope research): research_list_creators, research_add_creator, research_list_videos, research_analyze_video, research_remix_video, research_final_script, research_vault_list, research_vault_save, research_usage.

Loop tools (scope loop), the same functions as the strategist chat in the app: loop_create_board, loop_get_board, loop_add_node, loop_connect_nodes, loop_run_node, loop_propose_directions, loop_approve_direction, loop_run_gate, loop_list_top_picks, loop_approve_picks, loop_search_assets, loop_search_captured_ads, loop_get_audit, loop_get_usage. Steps that cost model calls first return the cost; call again with confirm: true once the person agreed. They also run over HTTP: POST /api/v1/loop with { tool, input }.

Other tools: generate_video, upscale_image, remove_background, get_credits, list_generations, search_skills, get_skill, meta_ads_account, meta_ads_list_campaigns, meta_ads_create_campaign (always created paused).

Add this to your MCP client config (Claude Desktop claude_desktop_config.json, a project .mcp.json, or Cursor ~/.cursor/mcp.json):

json — json
{
  "mcpServers": {
    "intentos": {
      "command": "npx",
      "args": ["-y", "@spycy/mcp"],
      "env": { "INTENTOS_API_KEY": "sk_live_your_key" }
    }
  }
}

Claude Code: claude mcp add intentos --env INTENTOS_API_KEY=sk_live_your_key -- npx -y @spycy/mcp

Give the key the scopes it needs when you create it: research, studio, media, leads, skills or all. A tool called with a key that lacks its scope returns an error naming the missing scope.

Restart the client, then try: “List my tracked creators and break down the biggest outlier from this week.”

The server exposes search_skills and get_skill. Ask your assistant to “find an Intentos skill for carousel posts” or “use the Intentos skill product-ad-set”: it loads the skill's instructions and follows them with the generation tools.