Optimly Developer Documentation

Start

MCP, Agent API, or Optimly Agent?

In short

Choose how to use Optimly from an agent, build it into software, or run the workflow with your team in Slack.

Choose based on where you want Optimly to work and who should run the workflow.

MCP lets you use Optimly from your agent. The API lets you build Optimly into your software. The Optimly Agent runs the workflow with your team in Slack.

Optimly MCPOptimly Agent APIOptimly Agent in Slack
Best forPeople using an MCP-compatible agentTeams building a product, integration, or automationTeams that want Optimly to keep the work moving
Where it runsIn your MCP client, such as Claude or CodexIn your application, service, or agent harnessIn a shared Slack channel, backed by Optimly
Who operates itYou and your agentYour engineering team and softwareOptimly, with your team providing context and approvals
What it enablesConversational access to authorized brand evidence and toolsVersioned, programmatic access to capabilities and governed actionsOngoing research, prioritization, preparation, coordination, verification, and measurement
Control modelThe client discovers the tools your account can useYour software discovers capabilities and handles orchestrationOptimly proposes the next step; your team reviews consequential decisions and controls publication
Paid accessOptimly Platform for non-action tools; Execution Program for action workflowsOptimly Platform for non-action capabilities; Execution Program for action workflowsIncluded with the AI Brand Execution Program
Start hereConnect Optimly MCPUse the Agent APIBook an Optimly Agent onboarding call

Access and pricing

MCP and Agent API credentials require paid access. The free AI Brand Index does not include either credential.

PlanPriceMCP and Agent API accessOptimly Agent in Slack
AI Brand IndexFreeNo credentials; includes the public Business Profile, one AI Brand Snapshot, and one recommendationNot included
Optimly Platform$800/monthRead and non-action capabilities for measurement, evidence, monitoring, the prioritized queue, and recommendationsNot included
AI Brand Execution ProgramFrom $4,000/monthPlatform capabilities plus governed action workflowsIncluded; Optimly works through twelve delivered actions a month with your team

Review current pricing and plan details. Paying never changes factual accuracy, ranking, citations, or recommendations. It changes the ongoing measurement, access, and execution services available to the account.

Action access is not permission to publish automatically. The authenticated account must have the required permissions, and consequential actions still require the documented human approval and execution-ledger workflow.

Agent-assisted setup

An agent can guide and verify this setup, but it must stop for an authorized user at payment, authorization, and secret-handling checkpoints.

  1. Choose the interface. Use the comparison above to select MCP, the Agent API, or the managed Optimly Agent in Slack.
  2. Establish the brand. Ask the user to sign in to Optimly, claim or select the correct brand, and confirm its Business Profile. Do not guess which organization or brand to use.
  3. Choose access. Use Optimly Platform for MCP or API access to non-action capabilities. Use the AI Brand Execution Program when the team wants governed action workflows or the Optimly Agent in Slack.
  4. Hand off payment or onboarding. Show the user the current pricing page. The user must choose the plan and personally confirm any purchase. For the Execution Program, book an onboarding call. Do not enter or submit payment details on the user's behalf.
  5. Confirm activation. Continue only after Optimly shows the paid access on the correct account and brand. A receipt or completed form is not proof that access has been provisioned.
  6. Authorize the connection. For MCP OAuth, configure https://scout.optimly.ai/mcp and ask the user to complete sign-in, consent, and brand selection. For a manual MCP or Agent API connection, ask the user to authorize creation of a brand-scoped key in Optimly under Scout → Advanced setup and API keys. Treat the key as a secret and never place it in a prompt, log, screenshot, browser bundle, or source control.
  7. Verify before working. Call MCP tools/list or Agent API /capabilities, confirm the returned organization and brand, and use only the tools or capabilities advertised for that credential.
  8. Stop on missing access. If the server returns 401 or 403, or an expected tool is absent, do not bypass the restriction or try another customer's credential. Ask the user to confirm the plan and brand permissions or contact Optimly.

Use MCP when

Use Optimly MCP when a person wants to work with Optimly through an MCP-compatible agent. The client handles the conversation and orchestration; Optimly supplies the authorized evidence, tools, and governance boundaries available to that account.

For example, a brand team could connect Optimly to Claude or Codex and ask it to:

  • retrieve the brand's verified Business Profile before writing positioning;
  • inspect the latest authorized audit, monitoring, or competitive evidence;
  • prepare governed recommendation work using the tools returned by tools/list.

MCP is the fastest path when the experience already lives inside an agent and you do not need to build or maintain an integration.

See the complete MCP tool reference.

Use the Agent API when

Use the Optimly Agent API when software—not a person in an MCP client—needs to call Optimly. Your application owns the user experience, scheduling, orchestration, retries, and error handling. Optimly enforces brand scope, permissions, approval requirements, and the execution ledger.

For example, a product team could build a service that:

  • reads the API's advertised capabilities for the authorized brand;
  • brings Optimly evidence or recommendation state into an internal product or workflow;
  • proposes and tracks approved actions through a durable, versioned integration.

Choose the API when the integration must run predictably in your own system or serve a custom interface.

Use the Optimly Agent in Slack when

Use the Optimly Agent when the goal is not to build an integration, but to have the workflow run with your team. Optimly keeps research, preparation, coordination, verification, and measurement connected while your team supplies context, reviews work, and controls consequential approvals and publication.

For example, a brand team could use a shared Slack channel to:

  • see the next evidence-backed brand action and why it matters;
  • answer questions or review a prepared change without learning a new tool;
  • approve what should move forward and follow the result through verification and measurement.

Book an Optimly Agent onboarding call.

You can combine them

These options are not mutually exclusive. A team can use MCP for ad hoc work in an agent, the API for a durable internal integration, and the Optimly Agent in Slack to keep the human approval and execution loop moving.

For one team, that could mean exploring evidence with MCP, syncing approved state into an internal system through the API, and coordinating decisions with the Optimly Agent in Slack. Optimly remains the source of record for permissions, recommendation state, approvals, and execution history across those surfaces.