uare.ai Experts MCP server

The uare.ai Experts MCP server brings experts' AIs into the assistants people already use. An assistant such as ChatGPT or Claude finds a listed expert for what a person needs, the person talks to that expert's AI as a visitor without leaving their conversation, and they can continue with the expert on uare.ai.

https://app.uare.ai/api/v1/public/mcp

It's a public, remote MCP server over the streamable HTTP transport. It needs no API key and no sign-in, and it reaches only what any visitor can see: listed experts' public profiles, and the answers their AIs give in public mode.

#How it works

1. A person asks their assistant: "I'm running my first marathon in April. Who could help me plan my training?"
2. The assistant calls find_experts with that need. uare.ai searches the experts it lists and returns up to three, each with a one-line reason, or says that none matches.
3. The person picks Ana, a running coach. The assistant calls ask_expert with their message, and Ana's AI answers as it would a visitor on her public profile. The reply is labelled as her AI's: "The AI of Ana replied".
4. With the next message, the assistant passes back the consult value from that reply, so Ana's AI remembers the conversation. See Keep a conversation going.
5. expert_profile shows more about Ana: her bio, her public services and a link to her page. When the conversation's free messages run out, the reply sends the person to that page.

#What experts should know

• You choose to be listed. Only listed experts appear: find_experts searches only them, and ask_expert and expert_profile answer only for them. For now, uare.ai lists experts who agree to it. Once the uare.ai Experts app is in ChatGPT's and Claude's directories, a setting in your AI's settings (Settings → ChatGPT & Claude) lets you list your AI yourself, and take it down at once. Only a personal AI can be listed, not an organization's, and places are limited for now. uare.ai can take a listing down and keep it down.
• Your AI must be public. A listed expert appears only while their AI is public. Make your AI private and it stops appearing and answering there at once.
• You must be verified and 18 or older on record. The same rule uare.ai's own search uses: a listed expert appears only while their identity is verified and their account shows them as 18 or older, from the birthday on their profile or the date of birth their identity check confirmed. Without an age on record they don't appear, even when listed.
• It answers as on your public profile. Your AI answers in public mode, from the knowledge you've made public, without your private notes or connected apps. Replies are labelled as your AI's, never as you in person.
• You see the conversations. Conversations through these assistants are visitor conversations: they show with your AI's other guest conversations, beside chats from your public profile and your website. Like any guest, the person is anonymous.
• Prices stay on uare.ai. expert_profile lists your public services by name, category and description, never with a price. In other assistants it can add whether a service is free or for subscribers; inside ChatGPT it leaves that out too. People see your prices on your page.
• People continue on your page. Results link to your public profile. When a conversation's free messages run out, or a daily limit is reached, the reply sends the person there to keep talking to your AI.

#Connect it for testing

To try the server, add it to an assistant yourself, as a custom MCP server with no sign-in. Assistants may ask before each ask_expert call, because it sends the person's message to uare.ai. find_experts and expert_profile are marked read-only.

#Claude

In Claude on the web, Claude Desktop or Cowork, open Customize → Connectors, select + Add, then Add custom connector. Name it, for example uare.ai Experts, paste the URL above, choose No sign in, then select Add. Turn it on in a conversation from the + menu, under Connectors.

On Team and Enterprise plans, an Owner adds the connector first, in Organization settings → Connectors. Anthropic's guide, Get started with custom connectors using remote MCP, has the current steps.

In Claude Code, one command adds it:

claude mcp add --transport http uare-experts \
  https://app.uare.ai/api/v1/public/mcp

#ChatGPT

In ChatGPT on the web, open Plugins, select the plus button, then Add custom MCP server. Enter a name, paste the URL above as the Server URL, choose No authentication, accept the risk warning and select Create as a plugin. Install the plugin from your personal plugins, then type @ in a conversation and pick it.

Workspace settings can restrict custom MCP servers. OpenAI's guide, Add custom MCP server, has the current steps.

#Your own code

Any MCP client can use the server. In Node.js, with the official SDK:

npm install @modelcontextprotocol/sdk

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const client = new Client({ name: "my-assistant", version: "1.0.0" });
await client.connect(
  new StreamableHTTPClientTransport(new URL("https://app.uare.ai/api/v1/public/mcp")),
);

const found = await client.callTool({
  name: "find_experts",
  arguments: { need: "I am running my first marathon in April and need a training plan" },
});
const [expert] = found.structuredContent?.experts ?? [];

if (!expert) {
  // No listed expert is close enough: the text says so.
  console.log(found.content[0].text);
} else {
  const ask = (message, consult) =>
    client.callTool({
      name: "ask_expert",
      arguments: { expert_id: expert.expert_id, message, ...(consult && { consult }) },
    });

  const first = await ask("I run 20 km a week. Can I be ready for a marathon in April?");
  console.log(first.content[0].text);

  // Pass the consult back to stay in the same conversation.
  const second = await ask("What should my long runs look like?", first.structuredContent?.consult);
  console.log(second.content[0].text);
}

await client.close();

The server keeps no session, so a single request can call a tool, with no initialize first:

curl -s https://app.uare.ai/api/v1/public/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"find_experts","arguments":{"need":"I am running my first marathon in April and need a training plan"}}}'

It answers with an event: message line whose data holds the JSON-RPC result.

#Tools

Each result has a text block written for the assistant's model, and the same data as JSON in structuredContent for your own code. An error is a result with isError: true and a message to show the person: see Errors.

#find_experts

Finds up to three listed experts whose AI can help with a need, best match first. uare.ai compares the need with each listed expert's public profile and keeps only close matches. When none is close enough, experts is empty and the text says No uare.ai expert matches this need yet.

{
  "experts": [
    {
      "expert_id": "08aeb20d-b364-4dd4-a36e-7c5c55887015",
      "name": "Ana",
      "reason": "Story: Ana has coached first-time marathoners for ten years.",
      "profile_url": "https://app.uare.ai/p/08aeb20d-b364-4dd4-a36e-7c5c55887015?utm_source=claude&utm_medium=assistant&utm_campaign=uare_experts_app"
    }
  ]
}

#ask_expert

Sends a message to an expert's AI and returns its reply. The expert's AI answers in public mode, as it would a visitor on the expert's public profile.

The text block gives the model the reply, then the consult value with an instruction to pass it back:

The AI of Ana replied:

Yes, if you build up gradually. How many times a week do you run now?

consult: eyJhbGciOiJIUzI1NiJ9…
Pass this consult value with the next ask_expert call to continue this conversation (4 free messages left). More from Ana: https://app.uare.ai/p/08aeb20d-b364-4dd4-a36e-7c5c55887015?utm_source=claude&utm_medium=assistant&utm_campaign=uare_experts_app

structuredContent holds the same:

{
  "expert": {
    "expert_id": "08aeb20d-b364-4dd4-a36e-7c5c55887015",
    "name": "Ana",
    "avatar_url": "https://…/ana.png"
  },
  "reply": "Yes, if you build up gradually. How many times a week do you run now?",
  "consult": "eyJhbGciOiJIUzI1NiJ9…",
  "new_conversation": false,
  "remaining_free_messages": 4,
  "suggestions": [
    { "label": "Plan my long runs", "prompt": "What should my long runs look like?" }
  ],
  "profile_url": "https://app.uare.ai/p/08aeb20d-b364-4dd4-a36e-7c5c55887015?utm_source=claude&utm_medium=assistant&utm_campaign=uare_experts_app"
}

When a limit is reached, ask_expert returns a hand-off instead of a reply: see Limits.

#expert_profile

Returns an expert's uare.ai profile, the services they offer and a link to their page.

{
  "expert": {
    "expert_id": "08aeb20d-b364-4dd4-a36e-7c5c55887015",
    "name": "Ana",
    "avatar_url": "https://…/ana.png",
    "bio": "Running coach. I help first-time marathoners train without getting hurt.",
    "profile_url": "https://app.uare.ai/p/08aeb20d-b364-4dd4-a36e-7c5c55887015?utm_source=claude&utm_medium=assistant&utm_campaign=uare_experts_app"
  },
  "services": [
    {
      "name": "Marathon plan review",
      "category": "education",
      "description": "I read your training plan and tell you what to change.",
      "access": "for subscribers"
    },
    { "name": "Ask me about your first 10K", "access": "free" }
  ]
}

services lists the expert's published public services, featured ones first. Each has a name and, when they're set, a category and a one-line description. access says free or for subscribers when the service is one of those. No price is ever included, and inside ChatGPT access is left out too. If the services can't be read, services is null, the text says so, and the rest of the profile still comes back.

#Keep a conversation going

The server keeps no session between calls. The consult value is the conversation: ask_expert returns one with every reply, in structuredContent and on the consult: line of its text, and the assistant passes it back with the next message. Without it, ask_expert starts a new conversation.

• What the expert's AI remembers. Everything said in one consult, as in a visitor's chat on uare.ai, and nothing from other consults.
• How long it lasts. Up to two hours, and it ends sooner after an hour without messages.
• When it expires. ask_expert doesn't fail. It starts a new conversation with the same expert and says so: its text opens with Started a new conversation with the AI of Ana: the previous consult had expired., new_conversation is true, and it returns a new consult. That conversation counts as a new one in the daily limits.
• One message at a time. A message sent while the previous reply is still being written gets an error. Wait for the reply, then send.
• It belongs to one person and one expert. Keep it with that person's conversation, and treat it as opaque. A value that was changed, a session token from the public chat API, or another expert's consult gets an error that says why. It never quietly starts a new conversation.

#Limits

Conversations through the server are free, so it keeps to limits. They count per caller: one person, when the assistant identifies its user in a way uare.ai can verify, and otherwise one network address. Servers uare.ai recognizes as an assistant's, such as Anthropic's for Claude, count as one shared address with a larger allowance, because all of that assistant's users come through them. Daily limits reset at midnight UTC.

• Free messages per conversation. A consult includes the same free messages as a visitor's conversation on a website. Each reply says how many are left.
• New conversations per expert. A caller can start a limited number of new conversations with the same expert each day.
• Messages per day. Each caller has a daily share of messages, within a daily budget for the whole server.
• Requests per minute. Each caller can send only so many requests a minute, initialize and tools/list included. Past that, the server answers 429 with a Retry-After header.

Only ask_expert counts toward the daily limits, so find_experts and expert_profile keep working. When the free messages or a daily limit stop a message, ask_expert doesn't fail: it hands the person over to the expert's page. The result isn't an error, and structuredContent.handoff says why, with the link:

Each text ends with Continue with Ana on uare.ai: and the expert's page, which is also handoff.url. Show the person that link: on uare.ai they can keep talking to the expert's AI and sign up.

If uare.ai can't count requests or messages for a moment, it refuses them rather than letting them through uncounted.

#Errors

A tool that fails returns a result with isError: true and a message the assistant can show the person:

The HTTP request can also be refused before any tool runs: