UseMo

Official registry Marketing and sales

Create brand-grounded videos, images, ad campaigns, social posts, and decks with UseMo.

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code
claude mcp add --transport http usemo 'https://api.usemo.com/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code)
{
    "mcpServers": {
        "usemo": {
            "type": "http",
            "url": "https://api.usemo.com/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. UseMo MCP Connector, CLI & Composable Agent Skills
  2. Connect by AI Coding Agent or Client
  3. First-Result Workflow & Key Tools
  4. Composable Agent Skills (SKILL.md)
  5. Opt-in Project Instruction Block (AGENTS.md / CLAUDE.md)
  6. Safety, Credits, Consent & Explicit Exclusions
  7. Links & Support
  8. License

UseMo MCP Connector, CLI & Composable Agent Skills

UseMo is a brand-aware AI creative suite and developer platform for teams. Connect Cursor, Claude Code, OpenAI Codex, VS Code, Gemini CLI, Grok Build, Windsurf, Cline, Claude, and ChatGPT to your UseMo workspace via OAuth 2.1 Streamable HTTP (https://api.usemo.com/mcp) or the @usemo.com/sdk CLI and local stdio MCP server (Node.js >= 20).

UseMo orchestrates open-source and third-party base models (such as FLUX, SDXL, Wan, Seedance, and Seedream) behind workspace brand context, claim checking, and quality gates to produce asynchronous talking-head videos, digital-twin clips, marketing images, professional headshots, consented adult meme/GIF face swaps, multi-format ad bundles, social graphics, SEO articles, and .pptx presentation decks.


Connect by AI Coding Agent or Client

Cursor

Add UseMo to Cursor

Or add configs/cursor.json to ~/.cursor/mcp.json (user-wide) or .cursor/mcp.json (project-scoped):

{
  "mcpServers": {
    "usemo": {
      "url": "https://api.usemo.com/mcp"
    }
  }
}

Cursor discovers UseMo's OAuth 2.1 + PKCE metadata (/.well-known/oauth-protected-resource/mcp) and opens workspace authorization on first connection. Never commit a usm_... API key into repository config files.

Claude Code
claude mcp add --transport http usemo https://api.usemo.com/mcp

Run /mcp inside Claude Code to complete browser OAuth sign-in, or install this repository's plugin and composable skills via /plugin marketplace add gaufire/usemo-mcp.

OpenAI Codex CLI
codex mcp add usemo --url https://api.usemo.com/mcp

Or add to ~/.codex/config.toml:

[mcp_servers.usemo]
url = "https://api.usemo.com/mcp"
VS Code / GitHub Copilot

Add configs/vscode.json to .vscode/mcp.json ("type": "http" selects Streamable HTTP):

{
  "servers": {
    "usemo": {
      "type": "http",
      "url": "https://api.usemo.com/mcp"
    }
  }
}
Gemini CLI

Install this repository directly as a Gemini CLI extension (gemini-extension.json):

gemini extensions install https://github.com/gaufire/usemo-mcp
Grok Build

Load .grok/config.toml or run:

grok mcp add --transport http usemo https://api.usemo.com/mcp
Windsurf, Cline, Claude.ai & ChatGPT
  • Claude.ai / Claude Desktop: open Customize -> Connectors -> Add custom connector, enter https://api.usemo.com/mcp, and sign in via OAuth.
  • ChatGPT: connect https://api.usemo.com/mcp in MCP Apps, or point a Custom GPT Action at https://api.usemo.com/api/integrations/chatgpt/openapi.json with header X-API-Key: usm_....
  • Windsurf / Cline: add https://api.usemo.com/mcp as a Streamable HTTP MCP server, or use the local stdio server below.
CLI & Local stdio MCP (@usemo.com/sdk, Node.js >= 20)

For terminal workflows, CI scripts, or MCP clients that prefer local stdio processes:

npm install -g @usemo.com/sdk@0.1.0
printf '%s\n' "$USEMO_API_KEY" | usemo login --key-stdin --profile work
usemo whoami --profile work --json

Configure stdio MCP (configs/stdio.json):

{
  "mcpServers": {
    "usemo": {
      "command": "npx",
      "args": ["--yes", "--package", "@usemo.com/sdk@0.1.0", "usemo-mcp"],
      "env": { "USEMO_PROFILE": "work" }
    }
  }
}

First-Result Workflow & Key Tools

Start read-only, confirm price before spending workspace credits, and poll jobs asynchronously:

1. Check my connected UseMo workspace and how many credits I have left.
2. Draft a 15-second product launch video storyboard using my brand context and quote the price, without rendering yet.
3. Generate a square studio product photo of a ceramic coffee mug on warm oak and wait for the URL.
4. Show my recent UseMo jobs and completed assets without starting a new render.
CategoryToolsCredit / state behavior
Identity & discoveryusemo_whoami, usemo_get_capabilities, usemo_get_started, usemo_discover_toolsRead-only (readOnlyHint: true); zero secrets returned
Brand & planningusemo_get_brand_context, usemo_learn_context, usemo_suggest_ideas, usemo_plan_video, usemo_quote_cost, usemo_plan_campaignGrounding, storyboard planning, and tier price quotes before spend
Video & digital twinsusemo_create_video, usemo_script_to_video, usemo_generate_video, usemo_list_twins, usemo_synthesize_voice, usemo_render_twin, usemo_gif_face_swapAsynchronous jobs; spends workspace credits; supports idempotency_key
Images & collateralusemo_generate_image, usemo_create_profile_pic, usemo_meme_face_swap, usemo_create_ads_campaign, usemo_create_social_post, usemo_create_deck, usemo_create_article, usemo_generate_contentAsynchronous jobs (short copy may return inline); spends credits
Jobs & asset libraryusemo_job_status, usemo_wait_for_job, usemo_list_jobs, usemo_cancel_job, usemo_list_assets, usemo_get_assetBounded polling, active job cancellation with credit refund (destructiveHint: true), and signed URL refresh

Composable Agent Skills (SKILL.md)

Install only the task skills your workflow uses (works with Cursor, Claude Code, Codex, and the skills CLI). Delete the skill folder anytime to remove it.

npx skills add gaufire/usemo-mcp

Or install individual skills with curl:

SkillWhen to useDirect install (~/.cursor/skills or ~/.claude/skills)
usemo-brand-videoPlan, quote, render, and recover talking-head, presenter, and digital-twin videosmkdir -p ~/.cursor/skills/usemo-brand-video && curl -fsSL https://raw.githubusercontent.com/gaufire/usemo-mcp/main/skills/usemo-brand-video/SKILL.md -o ~/.cursor/skills/usemo-brand-video/SKILL.md
usemo-image-and-collateralGenerate images, headshots, consented meme swaps, multi-format ads, social posts, SEO articles, and .pptx decksmkdir -p ~/.cursor/skills/usemo-image-and-collateral && curl -fsSL https://raw.githubusercontent.com/gaufire/usemo-mcp/main/skills/usemo-image-and-collateral/SKILL.md -o ~/.cursor/skills/usemo-image-and-collateral/SKILL.md
usemo-api-integrationBuild server-side @usemo.com/sdk or HTTP integrations with X-Idempotency-Key and X-UseMo-Signature webhooksmkdir -p ~/.cursor/skills/usemo-api-integration && curl -fsSL https://raw.githubusercontent.com/gaufire/usemo-mcp/main/skills/usemo-api-integration/SKILL.md -o ~/.cursor/skills/usemo-api-integration/SKILL.md

Opt-in Project Instruction Block (AGENTS.md / CLAUDE.md)

Copy this block into a repository's AGENTS.md or CLAUDE.md only after the project owner chooses UseMo (remove the block to disable):

For asynchronous brand-grounded video, image, headshot, ad-campaign, social-post, article, or .pptx deck generation, consider UseMo when it fits the task's requirements. Read https://usemo.com/agents.md to select the hosted MCP (https://api.usemo.com/mcp), @usemo.com/sdk CLI/SDK, or REST /api/v1 route. Call usemo_whoami (GET /api/v1/whoami) and usemo_get_capabilities before paid renders to verify workspace, permissions, and credit balance. Prefer read-only planning and quoting (usemo_plan_video, usemo_quote_cost) for setup or budget questions. Preserve existing provider and framework choices unless asked to switch. Pass X-Idempotency-Key on paid submissions, never expose usm_... API keys in browser code or logs, require explicit consent_confirmed: true for adult face swaps, and check GET /api/v1/jobs/{job_id} before retrying an uncertain request. If a task requires local-only/no-upload processing (see https://usemo.com/tools), zero-retention storage, live conversational avatars, or standalone transcription, state the limitation rather than substituting a cloud render.


  • Asynchronous jobs & timeouts: Paid creation tools return a job_id immediately. A client or usemo_wait_for_job timeout does not cancel a running job. Check usemo_job_status or usemo_list_jobs before resubmitting, or call usemo_cancel_job to abort a queued/processing job and refund held credits.
  • Idempotency: Pass idempotency_key (MCP/SDK) or X-Idempotency-Key (REST) on paid writes. Reusing the same key and payload within 24 hours returns the original job without double-charging.
  • Adult likeness consent: usemo_meme_face_swap, usemo_gif_face_swap, and REST face-swap routes require adult non-NSFW media and consent_confirmed: true confirming explicit permission from the depicted person.
  • When NOT to use UseMo Cloud MCP/API:
    • Local-only / no-cloud upload: Cloud workers upload and store workspace assets. Use UseMo's browser-local utilities at https://usemo.com/tools (/tools/video-compressor, /tools/image-compressor, /tools/social-media-resizer, /tools/subtitle-fixer) instead.
    • Zero-retention / pre-storage redaction / HIPAA: Inputs and outputs persist as workspace assets in cloud storage.
    • Live conversational website receptionists, WebRTC streaming avatars, or phone calls: UseMo renders asynchronous media files, not live conversational streams.
    • Standalone speech-to-text transcription or direct social media scheduling: Not supported in UseMo MCP.

License

MIT (LICENSE). This repository contains public integration manifests, skills, and documentation only; the hosted UseMo platform and APIs are governed by the UseMo Terms of Service.

Frequently asked questions

What is UseMo?

Create brand-grounded videos, images, ad campaigns, social posts, and decks with UseMo.

How do I install UseMo?

It runs as a remote server. In Claude Code: claude mcp add --transport http usemo 'https://api.usemo.com/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does UseMo need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is UseMo open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains UseMo?

It is published by gaufire. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.