PlainRouter SDK

PlainRouter is an independent arrival ledger and spend enforcement under the ad account. Agents can trust its reads because the platform being measured does not produce them, and its enforcement is structural, not advisory.

Connect to PlainRouter MCP

PlainRouter exposes a remote Streamable HTTP MCP server at https://plainrouter.com/mcp.

The server uses OAuth 2.1. Request only the mcp:use scope. Account access is limited to the advertising account approved by the human user. Complete OAuth authorization in your client's normal flow; do not place credentials in the endpoint URL. Review authentication before connecting an agent.

Claude (integrations UI)

In Claude's Integrations UI, add a remote MCP server and enter https://plainrouter.com/mcp. Complete the OAuth 2.1 authorization and approve only the human-selected advertising account.

Cursor (mcp.json)

Add the remote server to Cursor's mcp.json:

{
  "mcpServers": {
    "plainrouter": {
      "url": "https://plainrouter.com/mcp"
    }
  }
}

When Cursor prompts you, complete OAuth 2.1 and grant only mcp:use; the connection can access only the advertising account approved by the human.

Generic Streamable HTTP client

Configure the client's Streamable HTTP transport with endpoint https://plainrouter.com/mcp. Use its OAuth 2.1 flow to request only mcp:use, and send the resulting authorization through the client's standard HTTP authentication mechanism. Account access remains limited to the human-approved advertising account.

Sandbox remote

Use https://plainrouter.com/mcp/sandbox to test an MCP integration without credentials or an advertising account. Every response is synthetic and marked as sandbox data; the remote cannot read production data, persist events, contact an advertising provider, or expose production-only tools that propose, write, or affect spend. Move to https://plainrouter.com/mcp and complete OAuth only when the integration is ready for real account data.

Agent Skills

This is PlainRouter's public repository for agent integrations and generated SDKs. It includes:

• repository guidance for Claude Code, Codex, Cursor, and Windsurf;
• Agent Plugin manifests for Claude Code and Codex;
• a Streamable HTTP MCP configuration for https://plainrouter.com/mcp; and
• three official Agent Skills:
  • get-ad-account-context for approved account context and read-only measurements;
  • verify-signal-ingestion for an idempotent identity-free onboarding check; and
  • propose-governed-ad-actions for evidence-backed proposals subject to policy and human approval.

Install the skills with the open Agent Skills CLI:

npx skills add plainrouter/sdk

Tools

The live MCP server advertises these tools. Availability remains limited by the connection permissions and the human-approved advertising account.

Generated from PlainRouter's signed OpenAPI contract.

TypeScript SDK

Install the generated SDK:

npm install @plainrouter/sdk

Inject a Signal Tracker secret explicitly, then call a generated operation:

import { configurePlainrouter, listEvents } from "@plainrouter/sdk";

configurePlainrouter({
  signalTrackerSecret: process.env.PLAINROUTER_TOKEN!,
});

const response = await listEvents();

The default API base URL is https://plainrouter.com/api/v1. The SDK never embeds credentials.

Python SDK

Install the Python SDK:

python -m pip install plainrouter

from plainrouter import create_client, list_events

client = create_client("your-signal-tracker-secret")
response = list_events.sync(client=client)

Python 3.11 or newer is required. Python package releases are versioned independently from the API contract and are verified against the vendored, signed OpenAPI contract before publication.

Ruby SDK

Install the Ruby gem:

gem install plainrouter-sdk

Use the compact client facade for the three API areas:

require "plainrouter"

client = PlainRouter::Client.new(
  token: ENV.fetch("PLAINROUTER_TOKEN")
)

events = client.operations.list_events(per_page: 25)

Ruby 3.2 or newer is required. The complete generated models and HTTP-aware methods remain available under PlainRouter::OpenAPI without crowding the top-level SDK documentation.

Go SDK

The generated Go client is published as its own standard Go module:

go get github.com/plainrouter/sdk-go@v0.5.0

CLI

Install the canonical scoped CLI globally:

npm i -g @plainrouter/cli
plainrouter --help

Or run the scoped package without installing it globally:

npx @plainrouter/cli --help

Python users can install the equivalent CLI from PyPI with pipx:

pipx install plainrouter
plainrouter --help

Both distributions expose the plainrouter command. Keep only one global installation on your PATH to avoid selecting an unintended executable.

Provide a Signal Tracker secret without placing it in shell history:

read -s PLAINROUTER_TOKEN
export PLAINROUTER_TOKEN
plainrouter events list
unset PLAINROUTER_TOKEN

The same CLI is also available from the official Homebrew tap:

brew install plainrouter/tap/plainrouter

Developer resources

Official developer resources: documentation, API documentation, and OpenAPI specification.

Official project: plainrouter.com · documentation · source

This repository is in 0.x development. Stability and support are not yet promised.