Paved MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Paved MCP or direct API to review sponsorships, search newsletter opportunities, manage campaigns, and track sponsorship details through natural language.

Paved logoPaved
Api Key

Paved is an all-in-one platform for managing newsletter sponsorships. It helps publishers and advertisers find, plan, and manage sponsorship campaigns.

31 Tools

Try Paved now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Paved
Try asking
TOOLS

Supported Tools

Every Paved action and event your agent gets out of the box.

Archive Ad Network Campaign

Archive an advertiser ad network campaign.

Clone Ad Network Campaign

Clone an advertiser ad network campaign, optionally overriding its details.

Create Ad Copy

Create an ad copy in an advertiser campaign.

Create Ad Network Campaign

Create an ad network campaign with its schedule, bid, targeting, and budgets.

Create Newsletter

Create a publisher newsletter from its name and website URL.

Delete Ad Copy

Permanently delete an ad copy from an advertiser campaign; it cannot be restored by this toolkit.

Delete Ad Network Campaign

Permanently delete an ad network campaign.

Get Ad Copy

Retrieve one ad copy from an advertiser campaign.

Get Ad Copy Stats

Retrieve performance statistics for one campaign ad copy.

Get Ad Network Campaign

Retrieve one campaign, optionally with related details and date-filtered ad-copy statistics.

Get Ad Network Campaign Stats

Retrieve performance statistics for one ad network campaign.

Get Newsletter

Retrieve one publisher newsletter by slug.

Get Publisher Placement Reporting

Retrieve placement-level earnings and reporting for a newsletter.

Get Publisher Placement Reporting By Placement

Retrieve reporting for one publisher newsletter placement.

Get Publisher Sponsorship

Retrieve one sponsorship for a publisher newsletter.

List Ad Copies

List the ad copies belonging to an advertiser campaign.

List Ad Copy Stats

List performance statistics for ad copies in an advertiser campaign.

List Ad Network Campaigns

List one page of ad network campaigns, optionally filtered by date or status and with caller-selected related details.

List Advertiser Sponsorships

List sponsorships for the authenticated advertiser.

List Newsletters

List all publisher newsletters with their slug, name, URL, and status.

List Publisher Placements

List ad network placements for a publisher newsletter.

List Publisher Sponsorships

Retrieve all sponsorships for a publisher newsletter.

Replace Ad Copy

Replace supplied ad-copy fields with PUT; Paved does not document how omitted fields are handled, while explicit null clears a field.

Replace Ad Network Campaign

Replace supplied campaign fields with PUT; Paved does not document how omitted fields are handled.

Replace Newsletter

Replace a newsletter's complete required name and URL representation using PUT.

Start Ad Network Campaign

Start campaign delivery, which can accrue ad spend immediately; stopping later does not reverse accrued spend.

Stop Ad Network Campaign

Stop campaign delivery to halt future ad spend; this does not reverse spend already accrued.

Submit Ad Network Campaign

Submit a campaign only when explicitly requested; Paved does not document the resulting stage, prerequisites, or edit restrictions.

Update Ad Copy

Partially update an ad copy in an advertiser campaign.

Update Ad Network Campaign

Partially update selected mutable fields of an ad network campaign.

Update Newsletter

Update a newsletter using PATCH; Paved still requires both name and URL in this operation.

SETUP GUIDE

Connect Paved MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["paved"],
  mcp: true,
});
Create a session scoped to Paved and read its MCP URL and headers
3

Connect your agent to the MCP server

typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "List my newsletter sponsorship campaigns in Paved",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a Paved request
SETUP GUIDE

Connect Paved API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["paved"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to Paved
3

Run Paved tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "List my newsletter sponsorship campaigns in Paved" }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the Paved tool calls through the session, and print the final answer

Why Use Composio?

AI Native Paved Integration

  • Supports both Paved MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable sponsorship tool execution
  • Rich coverage for finding, reviewing, and managing Paved sponsorship data

Managed Auth

  • Secure API key handling without hard-coding credentials in your agent
  • Central place to manage, scope, and revoke Paved access
  • Per user and per environment credentials for safer campaign workflows

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Paved
  • Scoped, least privilege access to Paved sponsorship resources
  • Full audit trail of agent actions to support review and compliance

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
FAQ

Frequently asked questions

Start with Paved.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Paved tool your agent needs.Free to start.

Start building