Help

Connect your AI assistant

Ask your territory questions in the assistant you already use. It answers from the same data as the site, under your plan, and says which year each figure is from.

The connector URL

https://medarep.com/api/mcp

Paste exactly this. An old address or an extra path will not sign in.

Before you start

  • A MedaRep account. Any plan works; the assistant sees what your plan sees on the site. Sign in or create one.
  • An assistant that takes custom connectors: Claude (web, desktop or mobile), Claude Code, ChatGPT with developer mode, Gemini, or any client that supports remote MCP servers with sign-in.

Claude, ChatGPT and Gemini rename their settings menus from time to time. If a step below does not match, look for Connectors or Apps in Settings.

Claude (claude.ai and the Claude app)

  1. Open Settings, then Connectors.
  2. Choose Add custom connector.

    Name it MedaRep and paste the connector URL. Leave the advanced settings empty.

  3. Choose Add, then Connect.

    A MedaRep window opens. Sign in with your emailed link, Google or Microsoft, check the account and plan it names, and choose Allow.

  4. Turn it on in a chat.

    In a new chat, open the tools menu under the message box and make sure MedaRep is switched on. Then ask a question.

A connector you add on the web also works in the Claude desktop and mobile apps.

Claude Code

  1. Add the server from a terminal.
    claude mcp add --transport http medarep https://medarep.com/api/mcp
  2. In Claude Code, run /mcp, pick medarep and choose Authenticate.

    Your browser opens the MedaRep sign-in. Choose Allow and go back to the terminal.

ChatGPT

  1. Turn on developer mode.

    Open Settings, then Apps & Connectors, then Advanced settings, and switch on Developer mode. It is on ChatGPT’s paid plans; on a Business or Enterprise workspace an admin may need to allow it.

  2. Back in Apps & Connectors, choose Create.

    Name it MedaRep, paste the connector URL, set authentication to OAuth, confirm you trust it, and create it.

  3. Sign in and choose Allow.
  4. Use it in a chat.

    From the + menu under the message box, choose developer mode and pick MedaRep.

Gemini

  1. On a computer, open gemini.google.com and choose Settings, then Connected Apps.

    Custom apps are added in the Gemini web app only. If Connected Apps is not there, choose Personal Intelligence first.

  2. Under Custom apps, choose Add a custom app and paste the connector URL.

    Leave Advanced features empty: Gemini registers itself with MedaRep, so there is no client ID or secret to enter. Choose Next.

  3. Sign in to MedaRep and choose Allow.

    The connect page names Google’s sign-in relay, oauth-redirect.googleusercontent.com, as where access goes. That is Gemini.

Google offers custom apps to personal Google Accounts (not work or school accounts), for people 18 or over in the US, in English, with Gemini Apps Activity kept on.

Other assistants and your own agent

Any client that supports remote MCP servers over HTTP with OAuth sign-in can connect: give it the connector URL and it finds the sign-in on its own. Clients that run on your computer sign in through your browser, the same way Claude Code does.

In Gemini CLI, for example:

gemini mcp add --transport http medarep https://medarep.com/api/mcp

Then run /mcp auth medarep inside Gemini CLI to sign in.

What you agree to when you sign in

The Connect page names the assistant, where its access goes, your account and your plan. The name is what the assistant calls itself, so allow it only if you started the connection yourself, just now, not from a link someone sent you.

Before you sign in, the assistant can already answer market questions: what is loaded, what a figure means, finding places, and the market outlook. Anything that names surgeons asks you to sign in first.

What the assistant can see and do

It canUnder the same rules as the site
Rank a territory’s surgeons, find new surgeons and moves, and show who already has themYour plan’s states and procedure categories get the full view; anywhere else gets the Free view.
Open surgeon, practice and hospital profilesA surgeon profile counts as a profile view, as if you opened it.
Find warm introductions from your customersUses the customers you marked on the site.
Company profiles, the competitor scorecard, product coverage and engagement movedNeed the product and company coverage add-on ($29 a month). Without it you get counts, not the tables.
Weekly “why now” briefs for a saved territoryCounts toward the same daily territory limit.

It can also change your own working data, only when you ask, and your assistant asks you to approve each change:

  • add surgeons to a list, or start a new list within your plan’s limit;
  • set a listed surgeon’s status or replace their note;
  • mark a surgeon as a customer, or unmark one;
  • save a territory (one with the same name is replaced).

It never deletes a list or a territory, and it cannot touch your plan, billing or team. Deleting stays on the site.

Starter prompts

MedaRep comes with ready-made prompts, so you do not have to know what to ask. In Claude, find them under the + menu in a chat, under MedaRep. In Claude Code and Gemini CLI they are slash commands.

PromptGives you
Get started with MedaRepWhat your plan covers, what you have saved, and three questions to ask first.
Weekly briefWho may be worth a call this week in a saved territory, with the reason, a warm path and a next step.
Prep for a surgeon callOne screen on one surgeon before you walk in, starting with what changed since your last visit.
Log a visit or callSay what happened in your own words; it saves the visit, where the account stands and the follow-up after reading them back.
What competitors just launchedNew FDA clearances in a procedure, read as new entrant, new system or line extension.
Size up a territoryTop targets for a procedure in a place, which companies engage them, who is new, and the outlook.
Competitor briefHow the companies in a procedure compare, and whose engagement moved in your territory.

Where your assistant does not list them (ChatGPT and the Gemini app may not), type the question instead.

With HubSpot in the same chat

If you keep your accounts in HubSpot, connect it on your account page first: your customers go there as contacts, their practices as companies, and your visits, calls, follow-ups and status changes as activities. Then add HubSpot’s own connector to the same assistant, beside MedaRep, and one chat can use both.

The two meet on the surgeon’s NPI: every contact MedaRep sends carries it in a field called medarep_npi. The assistant knows to look for it, so you can ask across both without naming it:

  • “Which of my HubSpot contacts are trending down in MedaRep this year?”
  • “Before my 2 pm with Dr. Bohl, give me his MedaRep profile and any open deals in HubSpot.”
  • “Build this week’s call list for knee replacement in Charlotte, and show which of them are already in my HubSpot.”

Questions to try

Name the procedure and the place. A metro, a state, a county or a territory you saved all work.

A territory

  • “Who are the top knee replacement surgeons in the Charlotte metro, and who already has them?”
  • “Which spine surgeons are new to Raleigh and not in the Medicare files yet?”
  • “Who moved or left in my saved territory this year?”

This week

  • “What should I work on this week in my Charlotte knee territory?”
  • “Who can introduce me to the top three shoulder surgeons in Greenville?”
  • “Add the first five to a list called Q1 targets.”

One surgeon or practice

  • “Tell me about this surgeon: cases, trend, who engages them, and where they operate.”
  • “Who decides at this practice, and is it hospital-employed?”
  • “Prep me for Dr. Patel tomorrow: what changed since my last visit?”
  • “Met Dr. Patel, still on Stryker, wants to try our knee. Follow up in March.”
  • “What follow-ups are due this week?”

Competitors and markets

  • “Who leads knee replacement on new clearances, recalls and momentum?”
  • “Which knee surgeons around Charlotte had a new main company in Open Payments last year?”
  • “How big will the hip replacement market in South Carolina be in 2030?”

Getting answers you can rely on

  • Case counts are Medicare fee-for-service unless the answer says all-payer or estimate. Ask it to say which.
  • Ask for the data year. Medicare runs about eighteen months behind, and every answer carries the year its figures describe.
  • Estimates (cases under CMS’s 11-patient floor, all-payer volume, forecasts, new-surgeon signals) are model output; the assistant is told to present them as estimates.
  • When a list is cut short by your plan, the answer says how many more there are.

More on how the figures are made in Your plan and the numbers. What your assistant can write, what is logged and what is refused: Compliance and your data.

If something goes wrong

It says the link expired.
The sign-in request lasts a few minutes. Start it again from your assistant.
It keeps asking me to sign in.
Remove the connector, add it again with the exact URL above, and sign in with the email your plan is on.
It answers, but leaves surgeons out or hides names.
That is your plan: the answer says how many were withheld and which states are outside your plan. Choose your states under Account.
Company and competitor answers are only counts.
Those need the product and company coverage add-on ($29 a month), under Account.
Gemini says it could not connect to this server.
Check that you are on a personal Google Account with Gemini Apps Activity on, then remove the custom app and add it again. If it still fails, write to us: it may be on our side.
It says to slow down.
Assistants can call MedaRep many times for one question. Wait a minute and ask again, or narrow the question.
How do I disconnect it?
Under Account, AI assistants, choose Disconnect next to it: it stops at once. Remove the connector in the assistant too, or it will ask you to sign in again.
Did it connect?
Under Account, AI assistants lists every assistant you allowed, with when it was last active.

Still stuck? Write to spd@medarep.com with the assistant you use and what it said.

NextConnect HubSpotSend your customers, visits, calls and follow-ups to your HubSpot CRM, one way and within seconds.