New Feature

Model Context Protocol
(MCP) Documentation

Securely connect AI clients to Infloso actions. Search creators, manage lists, and automate campaign workflows using the standard MCP interface.

Quick Start

1Read the MCP spec
2Point your client to: https://mcp.infloso.ai/mcp
3Authenticate via **OAuth** or **API Key**

Verification Steps:

Call myDetails to verify access
Run searchCreator

Overview

Infloso MCP (Model Context Protocol) lets AI clients securely call Infloso actions (tools) over a standard MCP interface, so users can search creators, manage lists, and run campaign workflows from one assistant/chat environment.

For Engineers

Integrate AI clients and workflows quickly using a standard tool-calling contract.

For Product/Ops

Understand available actions and where automation fits into daily marketing workflows.

Core URLs / URIs

Core Server URL

https://mcp.infloso.ai/mcp

Use the core URL as the MCP server endpoint in your client configuration. Tools are invoked by their standard name (e.g., searchCreator) rather than separate REST endpoints.

Authentication

OAuth

Best for user-scoped, interactive connections (Claude desktop/web-style flows). Users sign in and grant access, while the client manages token refreshes automatically.

API Key

Best for backend automations, n8n jobs, and service accounts. Generate a key in your Infloso dashboard and include it in your client's auth configuration.

Unauthorized or expired credentials will return auth errors during tool execution. Identity-sensitive tools require a valid account context.

Implementation Guide

Client Setup

Claude Desktop

1. Open MCP settings
2. Add server URL
3. Complete OAuth
4. Verify with myDetails

n8n

1. Create credentials
2. Add MCP node
3. Configure endpoint
4. Map workflow triggers

Claude Web

1. Open connector panel
2. Register endpoint
3. Authenticate
4. Start prompting

openclaw

1. Update config file
2. Restart runtime
3. Validate tool load
4. Wire to agent policy

Example Client Config

config.json

{
  "mcpServers": {
    "infloso": {
      "url": "https://mcp.infloso.ai/mcp",
      "auth": {
        "type": "api_key",
        "apiKey": "${INFLOSO_API_KEY}"
      }
    }
  }
}

Available Tools

Server	Tool	Description	When to Use
Infloso MCP	myDetails	Fetch current authenticated user profile and associated account details.	Validate auth and account context before workflows.
Infloso MCP	walletBalance	Fetch current user wallet summary (balance, total credits).	Check available credits before running discovery/campaign tasks.
Infloso MCP	getCreatorDetails	Fetch creator profile by platform + username with key metrics.	Inspect a specific creator before adding to list/campaign.
Infloso MCP	refreshProfile	Trigger profile data refresh for one/all creator platforms.	Force latest creator data before decisioning.
Infloso MCP	searchCreator	Natural-language creator search that converts query into filters.	Discovery from plain-language business queries.
Infloso MCP	getList	Fetch a saved creator list by ID with filtering/pagination support.	Read or paginate an existing list for review/export.
Infloso MCP	addToList	Add a creator (platform/username) to an existing saved list.	Curate lists incrementally from search/detail results.
Infloso MCP	createList	Create a new saved creator list.	Start a new shortlist for campaign planning.
Infloso MCP	createCampaign	Create a campaign with campaign settings and targeting inputs.	Move from planning to campaign execution setup.
Infloso MCP	campaignList	List campaigns for current account context with filters/sorting.	Monitoring dashboards and campaign operations.
Infloso MCP	campaignGet	Get full details of a single campaign by ID.	Drill into one campaign for status/audit/debug.

Example Usage Flows

Discovery & Curation

Search: "Find Indian skincare creators with high engagement"

Detail: Inspect top results with getCreatorDetails

Save: Add selected creators to "Q2 Skincare List"

Campaign Launch

Load: Fetch curated list using getList

Launch: Call createCampaign with list ID

Monitor: Check status with campaignGet

Troubleshooting

Auth failed / unauthorized

Check OAuth session or API key validity. Confirm token is attached to client config.

Tool not found

Verify MCP server URL is exactly https://mcp.infloso.ai/mcp. Refresh tools in your client.

No data returned

Confirm account context with myDetails. Try loosening filters in searchCreator.

Rate/timeout issues

Add retries with exponential backoff. Reduce batch size and use pagination.

Security & Permissions

Use **least privilege**: only grant required account access.
Prefer **OAuth** for user-delegated access and revocability.
Store **API keys** in a secret manager; never hardcode in prompts.
Rotate API keys on a regular schedule.
Audit logging: we log tool invocations for security monitoring.
Environment separation: use dev credentials for testing.

FAQ

What is MCP in Infloso?

A standards-based tool interface that allows AI clients to execute Infloso capabilities securely.

Do I need separate endpoints per tool?

No. Use the single MCP server URL and invoke tools by name.

Can non-engineering teams use this?

Yes. Product and Ops users can run guided workflows in compatible clients like Claude without writing code.

Go-live Checklist

MCP endpoint configured correctly

Auth method tested and verified

myDetails smoke test passes

Core discovery workflow tested

Retry/backoff logic implemented

Secrets stored in secure manager

Audit logging enabled

Production guardrails defined

Model Context Protocol (MCP) Documentation