@portaltexin/portal-mcp

MCP server for portal.texin.ai. Manage your Amazon Ads and Google Ads campaigns from Claude Desktop, Claude Code, Cursor, or any MCP-compatible client.

Quick start

1. Generate an API key at Settings > API Keys.

2. Add to your Claude config. Open your Claude Desktop config file and paste:

{
  "mcpServers": {
    "portal": {
      "command": "npx",
      "args": ["-y", "@portaltexin/portal-mcp"],
      "env": {
        "PORTAL_API_KEY": "pk_live_YOUR_KEY_HERE"
      }
    }
  }
}

Config file locations:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Claude Code / Cursor: Add via MCP settings in the IDE

3. Restart Claude and try: "List my campaigns"

Available tools

| Tool | Type | Description | | -------------------------- | ----- | ---------------------------------------------------------------------------------- | | list_campaigns | read | List campaigns across Amazon and Google with spend, sales, ACOS, ROAS | | get_campaign_details | read | Full details + top keywords for a single campaign | | pause_or_resume_campaign | write | Pause or resume a campaign (two-step confirmation) | | update_campaign_budget | write | Change daily budget (two-step confirmation) | | list_plan_templates | read | Browse available strategy plan templates | | generate_plan | write | Create a draft strategy plan from a template | | get_plan_details | read | Review a plan before launching | | launch_plan | write | Launch a draft plan with real ad spend (two-step confirmation + post-launch audit) | | list_keywords | read | Keywords with effective bids and performance | | list_search_terms | read | Customer search terms with sales attribution | | add_negative_keyword | write | Block a search term from triggering ads (two-step confirmation) | | get_account_summary | read | High-level account performance with period comparison |

Two-step confirmation

Write tools that affect real ad spend require confirmation. On the first call, you get a preview of exactly what will change. Claude shows this to you. Only after you approve does the tool execute.

This protects against accidental pauses, budget changes, and plan launches.

Rate limits

• General: 120 requests/minute per API key
• Burst: 30 requests in any 10-second window
• Heavy operations: 10/hour (plan generation, plan launches)

When you hit a limit, the tool returns a friendly message with the retry time.

Example prompts

• "Show me my top 10 campaigns by spend this week"
• "Which search terms are spending money but not converting?"
• "Draft a new SP unbranded exact plan for ASIN B0... targeting 4x ROAS"
• "Pause campaign XYZ, but show me what that will do first"
• "Compare my Amazon and Google ad performance this month"

Environment variables

| Variable | Required | Default | | ---------------- | -------- | ------------------------- | | PORTAL_API_KEY | Yes | - | | PORTAL_API_URL | No | https://portal.texin.ai |

Requirements

• Node.js 20+
• A portal.texin.ai account with an active subscription

License

MIT