PropellerAds MCP Server

Instructions

Implementation Reference

• src/propellerads_mcp/client.py:129-134 (handler)

  The method `stop_campaigns` in the `PropellerAdsClient` class sends a POST request to the `/adv/campaigns/stop` endpoint to pause campaigns.

  def stop_campaigns(self, campaign_ids: list[int]) -> dict[str, Any]:
      """Stop (pause) campaigns."""
      result = self._request(
          "POST", "/adv/campaigns/stop", json_data={"ids": campaign_ids}
      )
      return result

• src/propellerads_mcp/server.py:181-194 (registration)

  The tool `stop_campaigns` is registered in the MCP server with an input schema requiring a list of campaign IDs.

      name="stop_campaigns",
      description="Pause/stop one or more campaigns.",
      inputSchema={
          "type": "object",
          "properties": {
              "campaign_ids": {
                  "type": "array",
                  "items": {"type": "integer"},
                  "description": "List of campaign IDs to stop",
              },
          },
          "required": ["campaign_ids"],
      },
  ),

• src/propellerads_mcp/server.py:537-539 (handler)

  The `handle_tool` function in `server.py` routes the `stop_campaigns` tool call to the client's `stop_campaigns` method.

  elif name == "stop_campaigns":
      result = client.stop_campaigns(args["campaign_ids"])
      return f"Stopped campaigns: {args['campaign_ids']}\n\n{json.dumps(result, indent=2)}"