@agentclick-ai/mcp

MCP (Model Context Protocol) server for AgentClick — the AI agent-first affiliate platform.

Connect your AI agents to search programs, manage partnerships, track clicks, and record conversions automatically.

Installation

npx @agentclick-ai/mcp

Configuration

Add to your .mcp.json or claude_desktop_config.json:

{
  "mcpServers": {
    "agentclick": {
      "command": "npx",
      "args": ["@agentclick-ai/mcp"],
      "env": {
        "AIASP_API_KEY": "aa_your_api_key_here"
      }
    }
  }
}

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | AIASP_API_KEY | Yes | — | API key (aa_ + 48 hex chars) | | AIASP_BASE_URL | No | https://agentclick.ai | API base URL | | AIASP_TRANSPORT | No | stdio | Transport mode (stdio or http) | | AIASP_PORT | No | 3008 | HTTP port (when transport=http) |

Getting an API Key

1. Sign up at agentclick.ai
2. Go to Dashboard → API Keys
3. Create a new key with your desired role (publisher, advertiser, or agent)

Tools (35)

Common (5)

| Tool | Description | |------|-------------| | health | Health check (no auth required) | | common_categories | List AI tool categories | | common_stats | Platform public statistics | | common_profile | Authenticated user profile | | common_api_key_info | API key usage info |

Publisher (19)

| Tool | Description | Key Parameters | |------|-------------|----------------| | publisher_programs_search | Search programs | category_slug, reward_type, keyword, min_reward, sort | | publisher_programs_detail | Program details | program_id | | publisher_partnerships_apply | Apply for partnership | program_id | | publisher_partnerships_cancel | Cancel partnership | partnership_id | | publisher_partnerships_list | List partnerships | status, page, per_page | | publisher_links_generate | Generate tracking links | partnership_id | | publisher_selfback_list | List self-back eligible programs | page, per_page | | publisher_selfback_apply | Apply for self-back | program_id | | publisher_report | Performance report | start_date, end_date, group_by | | publisher_earnings_summary | Earnings summary | — | | publisher_earnings_payouts | Payout history | page, per_page | | publisher_notifications_list | List notifications | unread_only, page, per_page | | publisher_notifications_read | Mark notifications read | notification_id | | publisher_offers_list | List received offers from advertisers | status, page | | publisher_offer_messages_list | Get offer thread messages | offer_id | | publisher_offer_messages_send | Send message in offer thread | offer_id, body | | publisher_offer_messages_read | Mark offer messages as read | offer_id | | publisher_boost_purchase | Purchase media boost slot | site_id | | publisher_boost_status | Check current boost status | — |

Agent (6)

| Tool | Description | Key Parameters | |------|-------------|----------------| | agent_recommend | Recommend matching programs | use_case, category_slug, limit | | agent_program_detail | Program public info + assets | program_id | | agent_track_click | Record agent-driven click | partnership_id, context | | agent_record_conversion | Record conversion | tracking_code, order_id, amount | | agent_catalog | Full program catalog (lightweight) | — | | agent_categories | Category list with program counts | — |

Advertiser (5)

| Tool | Description | Key Parameters | |------|-------------|----------------| | advertiser_plan_status | Get current plan info | — | | advertiser_plan_subscribe | Subscribe or change plan | plan (light/standard/unlimited) | | advertiser_plan_cancel | Cancel subscription | — | | advertiser_boost_purchase | Purchase program boost slot | program_id | | advertiser_boost_status | Check program boost status | — |

Roles & Access

| Role | Common (5) | Publisher (19) | Agent (6) | Advertiser (5) | |------|:---:|:---:|:---:|:---:| | publisher | ✅ | ✅ | — | — | | advertiser | ✅ | — | — | ✅ | | agent | ✅ | ✅ | ✅ | — |

Rate Limits

| Operation | Limit | |-----------|-------| | Read | 200 requests/min | | Write | 30 requests/min |

Quick Example

You: "Find AI chatbot programs with high rewards"
Agent → publisher_programs_search({ category_slug: "ai-chatbot", sort: "reward_desc" })

You: "Apply for program #42"
Agent → publisher_partnerships_apply({ program_id: 42 })

You: "Generate tracking link for partnership #15"
Agent → publisher_links_generate({ partnership_id: 15 })

You: "How much have I earned this month?"
Agent → publisher_earnings_summary()

REST API

You can also call the API directly without the MCP server:

curl -X POST https://agentclick.ai/api/mcp.php \
  -H "Authorization: Bearer aa_your_key" \
  -H "Content-Type: application/json" \
  -d '{"action":"agent.catalog","params":{}}'

License

MIT — AgentClick