Skip to main content
Prerequisites Before you begin, create an account and get your API Key.

​
Getting started

Connect to Plai to create and manage Facebook, Instagram, and LinkedIn ad campaigns through AI agents.
  • API
  • UI
  • Open Source
1

Install the SDKs (optional)

pip install klavis
2

Create a Strata MCP Server with Plai

from klavis import Klavis
from klavis.types import McpServerName

klavis_client = Klavis(api_key="YOUR_API_KEY")

# Create a Strata MCP server with Plai
response = klavis_client.mcp_server.create_strata_server(
    servers=[McpServerName.PLAI],
    user_id="user123"
)

API Reference

Full Strata API endpoints
3

Authenticate with API Key

klavis_client.mcp_server.set_strata_auth(
    strata_id=response.strata_id,
    server_name=McpServerName.PLAI,
    auth_data={
        "api_key": "YOUR_PLAI_API_KEY"
    }
)
🎉 Your Plai MCP Server is ready! Once authentication is complete, you can use your MCP server URL with any MCP-compatible client.

​
Available Tools

Tool NameDescription
plai_create_user_profileCreate a new user profile on the Plai platform. This allows onboarding new users into the system.
plai_get_user_profileRetrieve the current user profile using their email address.
plai_create_linkGenerate a link that allows users to connect their Ad accounts (Facebook/Instagram or LinkedIn).
plai_create_leads_dynamicCreate a dynamic Facebook Lead Ad campaign. Lead generation ads collect contact information directly from users on Meta platforms.
plai_get_campaign_insightsFetch campaign insights for a specific campaign with performance metrics.
plai_update_campaign_statusUpdate the status of a campaign (pause, activate, or delete).
plai_check_leadform_tosCheck whether the user has accepted the Terms of Service for their connected Facebook page.
plai_create_leadformCreate a lead form for Facebook Lead Ads with predefined questions (EMAIL and FULL_NAME).
plai_get_leadform_listGet a list of all lead forms for the user.
plai_search_targeting_locationsSearch for advertising target locations based on search query. This helps in identifying relevant locations to improve the accuracy and effectiveness of ad targeting.
For more details about tool input schema, use the get_tools API.

​
Next Steps

AI Platform Integrations

Integrate Klavis MCP Servers with leading AI platforms

Integrations

Explore available MCP servers

API Reference

REST endpoints and schemas

White-label Authentication

Customize OAuth flows with your own branding
⌘I