Skip to main content
Semicola keeps the advertising records (advertisers, campaigns, creatives, media buys, storefronts, briefs and delivery) and does the work of reaching every connected seller. The v3 MCP endpoint exposes that work as tools an agent can discover and call. Your software brings the interface, the business data and the decisions it wants to own. You do not need to think of your project as “an advertising agent”. Start from the job: find places to advertise, compare offers, prepare and launch a campaign, answer briefs as a seller, or pull results into a report.

​
What people build

​
One endpoint, resolved by account

The URL is the same for everyone. What you see depends on the credential: a buyer account gets buyer tools, a seller account gets seller tools, and both get the shared tools. Call get_status first to learn which account is active and what stands in its way, and treat tools/list as the contract for your session. Tools that open a widget declare it with _meta.ui.resourceUri. In hosts that support MCP Apps, such as Claude and ChatGPT, the widget renders inline, just as it does in the Semicola app. Other clients receive the same data as structured content and a text summary.

​
MCP or REST

Use MCP when a model needs to discover capabilities and choose its next step. Use the REST API (https://api.semicola.com/api/v2/...) when your code already knows what to call, for example a nightly export. Both act on the same records.

​
Safety is part of the contract

  • Writes are idempotent. Every write takes an idempotencyKey; repeating it returns the first result.
  • Writes are versioned. Changes send expectedRevision; a stale value fails instead of overwriting someone else’s work.
  • Spending needs a person. Launching a campaign or approving a buy returns pending_confirmation first. Only a second call, made after the person agrees, commits it.
  • Missing facts become questions. A needs_input result asks for what is missing rather than guessing.

Connect in five minutes

Add the endpoint, sign in, and prove access with a read-only call.

MCP client setup

Host-by-host configuration and connection lifetime.

Authentication

OAuth for people, API keys for headless software.

v3 Tool Catalog

Every tool, its risk, its widget and its input fields.

Errors

Failure shapes and how to recover.

For agents

The short brief to hand an autonomous agent.