Services

MCP Server

Connect a PersonAIzer persona — or your whole account — to Claude Desktop, Claude Code, Cursor, or any MCP-compatible client. One remote server, five tools, no custom integration code: add the config below and the client discovers everything itself.

Connect

URLhttps://sessions.personaizer.com/mcp

TransportStreamable HTTP (stateless)

AuthX-Api-Key

Rate120/min

Two kinds of key, depending on what you want the client to do. A persona secret key (pa_…) scopes every call to one persona — get one from that persona's Developer tab in the dashboard. An account-level key (ak_…) isn't scoped to any persona — it's for tools that create or manage personas across your account. Get one from Account settings in the dashboard.

Stateless transport — every tool call is an independent request, same as the REST API. There's no MCP session to open or keep alive.

persona key — search, chat, upload

{
  "mcpServers": {
    "personaizer": {
      "url": "https://sessions.personaizer.com/mcp",
      "headers": { "X-Api-Key": "pa_..." }
    }
  }
}

account key — create & manage personas

{
  "mcpServers": {
    "personaizer": {
      "url": "https://sessions.personaizer.com/mcp",
      "headers": { "X-Api-Key": "ak_..." }
    }
  }
}

Persona-key tools

Scoped to one persona — authenticate with that persona's own secret key.

toolsearch_knowledge1 credit (fast) · 5 credits (smart)

Search the persona's knowledge base (site pages, documents, and products) for content relevant to a query — same retrieval as POST /v1/search.

toolchat1 credit

Send a message and get the persona's full reply, including any knowledge-base cards it surfaces — a non-streaming, call-and-wait variant of POST /v1/chat. Also works with an account-level key when personaId is given.

toolupload_knowledge_docs

Upsert structured knowledge documents (products, FAQs, etc.) into the persona's knowledge base. Persona secret key only — an account-level key is rejected here even if it can act on the same persona; create the persona first, then use its own key.

Account-key tools

Not scoped to any persona — authenticate with your account-level key.

toolcreate_persona

Start building a new persona from a website URL — scrapes the site, synthesizes an identity, generates an avatar, and (by default) harvests the site into the persona's knowledge base. Asynchronous (~1 minute) — returns job_id and persona_id; poll with check_persona_status.

toolcheck_persona_status

Poll the status of a persona build started by create_persona.