agentsmith-mcp

MCP server for Agent Smith — the AI marketing engine that learns your brand once, then creates on-brand content forever. Connect Claude, Cursor, or any MCP-compatible AI tool to your brand intelligence and content library.

Quick Start

1. Get your API key

Go to Agent Smith → Settings → API Keys and create a new key.

2. Configure your AI tool

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "agentsmith": {
      "command": "npx",
      "args": ["-y", "agentsmith-mcp"],
      "env": {
        "AGENTSMITH_API_KEY": "ask_your_key_here"
      }
    }
  }
}

Then restart Claude Desktop.

Claude Code

Add to your project's .mcp.json:

{
  "mcpServers": {
    "agentsmith": {
      "command": "npx",
      "args": ["-y", "agentsmith-mcp"],
      "env": {
        "AGENTSMITH_API_KEY": "ask_your_key_here"
      }
    }
  }
}

Or add globally via ~/.claude/settings.json.

3. Try it

"Create a LinkedIn post about personal branding and save it to Agent Smith"

The AI will use the tools automatically — no curl commands needed.

Tools (11)

Brand & Strategy

| Tool | Description | |------|-------------| | get_brand | Fetch your brand voice, products, personas, and identity. Supports markdown and JSON formats with section filtering. | | list_pillars | List content pillars with topics, keywords, frequency, and content counts. | | list_people | List brand people with headshot URLs and LoRA models for AI image generation. |

Content Library

| Tool | Description | |------|-------------| | create_content | Create blog posts, LinkedIn posts, tweets, emails, ad copy, and more. Supports scheduling and funnel stages. | | list_content | Browse your content library with filters (type, status, search, funnel stage) and pagination. | | get_content | Get a single content item with full body, metadata, and attached images. |

Recipes (AI Workflows)

| Tool | Description | |------|-------------| | list_recipes | List available content recipes — multi-step AI workflows for generating content. | | execute_recipe | Run a recipe to generate content using your brand intelligence. Returns results when complete. | | check_recipe_status | Check the status of a running or completed recipe execution. |

Images

| Tool | Description | |------|-------------| | upload_image | Upload an image to brand assets via URL or base64. Optionally associate with a brand person. | | attach_image | Attach or replace the featured image on an existing content item. |

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | AGENTSMITH_API_KEY | Yes | Your API key (starts with ask_) | | AGENTSMITH_BASE_URL | No | Override the API URL (default: https://www.agentsmith.to) |

How It Works

Claude / Cursor / Any MCP Client
        ↓ (MCP protocol over stdio)
agentsmith-mcp (this package)
        ↓ (HTTPS + Bearer token)
Agent Smith API
        ↓
Your Brand Intelligence & Content Library

The server is a thin wrapper — it translates MCP tool calls into authenticated API requests. No data is stored locally.

License

MIT