Skip to main content
Glama
bcharleson

Instantly MCP Server

get_campaign

Retrieve detailed campaign information including sequences, schedules, sender accounts, tracking settings, and status statistics from the Instantly.ai email outreach platform.

Instructions

Get campaign details: config, sequences, schedules, sender accounts, tracking, status.

Returns comprehensive campaign information including:

  • Email sequences and their content

  • Schedule configuration

  • Sender account assignments

  • Tracking settings (opens, clicks)

  • Campaign status and statistics

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
paramsYes

Implementation Reference

  • The main execution handler for the 'get_campaign' tool. Fetches detailed campaign information from the Instantly API using the provided campaign_id and returns it as formatted JSON.
    async def get_campaign(params: GetCampaignInput) -> str:
        """
        Get campaign details: config, sequences, schedules, sender accounts, tracking, status.
        
        Returns comprehensive campaign information including:
        - Email sequences and their content
        - Schedule configuration
        - Sender account assignments
        - Tracking settings (opens, clicks)
        - Campaign status and statistics
        """
        client = get_client()
        result = await client.get(f"/campaigns/{params.campaign_id}")
        return json.dumps(result, indent=2)
  • Pydantic input schema for the get_campaign tool, defining the required 'campaign_id' parameter.
    class GetCampaignInput(BaseModel):
        """Input for getting campaign details."""
        
        model_config = ConfigDict(str_strip_whitespace=True, extra="ignore")
        
        campaign_id: str = Field(..., description="Campaign UUID")
  • MCP tool registration annotation specifying that 'get_campaign' is read-only.
    "get_campaign": {"readOnlyHint": True},
  • The CAMPAIGN_TOOLS list that includes the get_campaign function, used by the server for tool collection and registration.
    CAMPAIGN_TOOLS = [
        create_campaign,
        list_campaigns,
        get_campaign,
        update_campaign,
        activate_campaign,
        pause_campaign,
        delete_campaign,
        search_campaigns_by_contact,
    ]

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/bcharleson/instantly-mcp-python'

If you have feedback or need assistance with the MCP directory API, please join our Discord server