Wire an MCP-aware AI agent

Discover the MCP server

The brandRNA MCP server lives at https://mcp.brandrna.com. Point your client there and let it negotiate the protocol:

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";

const transport = new SSEClientTransport(
  new URL("https://mcp.brandrna.com"),
);
const client = new Client(
  { name: "my-agent", version: "1.0.0" },
  { capabilities: {} },
);
await client.connect(transport);

from mcp.client.sse import sse_client
from mcp import ClientSession

async with sse_client("https://mcp.brandrna.com") as (read, write):
    async with ClientSession(read, write) as session:
        await session.initialize()
        # ... tool calls

Negotiate OAuth via Dynamic Client Registration

The brandRNA MCP server is an OAuth 2.1 provider. Most MCP SDKs handle DCR automatically — your client registers itself, kicks off the authorization code flow with PKCE, and receives an access token bound to the user's brandRNA account.

For the full handshake (registration, redirect, token exchange, revocation), see the OAuth dance explainer.

List the available tools

Once connected, your client can discover what tools the server exposes:

const tools = await client.listTools();
console.log(tools.tools.map((t) => t.name));
// ["get_brand_pack", "analyze_brand"]

get_brand_pack is your cache-first read. analyze_brand is the extraction trigger; it's slower (5–15s) and counts toward the user's monthly quota.

Call get_brand_pack first

Most domains worth fetching are already in our cache. Try the cheap read before the expensive extraction:

async function fetchOrAnalyze(domain: string) {
  try {
    const result = await client.callTool({
      name: "get_brand_pack",
      arguments: { domain },
    });
    return result;
  } catch (err: any) {
    // 404: not in cache yet
    if (err.code === -32000 && err.data?.reason === "not_found") {
      return null; // signal to caller to trigger analyze_brand
    }
    throw err;
  }
}

Fall back to analyze_brand on 404

If the cache miss returned null, kick off a fresh extraction. The MCP tool is async — it returns a job_id; poll until ready or wait on the SSE stream:

async function analyzeAndWait(url: string) {
  const job = await client.callTool({
    name: "analyze_brand",
    arguments: { url },
  });
  // Implementation depends on your client's polling model;
  // typical pattern: poll get_brand_pack(domain) every 2s up to 60s.
  return await pollUntilReady(job.content[0].text);
}

Handle billing attribution

The OAuth token your client holds maps to a managed key behind the scenes. Every get_brand_pack and analyze_brand call rolls up to the user's brandRNA account — /api/v1/usage on the REST surface reflects the same numbers.

If the user's quota is exhausted, the tool call returns the JSON-RPC error code -32001 (QuotaExceeded) with data.upgrade_url populated. Surface that link so the user can upgrade in-flow.