# Connecting apps

Connect an app that speaks MCP, such as Claude, ChatGPT or your editor, and ask it about your stats in your own words.

Connected, an app answers questions such as why traffic jumped on Tuesday or where this month’s sign-ups came from, using your figures and fivebar’s rules about what they mean, in a chat, in your editor or at the command line. In most apps, connecting takes a minute: add one address, sign in and choose Allow. The app can read your stats, and changes your settings only if you let it.

## The address

fivebar’s MCP server is at:

```
https://fiveb.ar/api/mcp
```

Add it to an app as a remote MCP server, which some apps call a connector or a custom app. The app then opens fivebar in your browser: sign in if you need to, and choose Allow. There’s no key or token to copy into the app.

These apps have a page each, with their own steps:

## Chat apps

- [Claude](https://fiveb.ar/docs/mcp/claude.md), Anthropic’s assistant, on the web, the desktop and phones: [add fivebar](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=fivebar&connectorUrl=https%3A%2F%2Ffiveb.ar%2Fapi%2Fmcp)
- [ChatGPT](https://fiveb.ar/docs/mcp/chatgpt.md), OpenAI’s assistant, on the web, in developer mode
- [Gemini](https://fiveb.ar/docs/mcp/gemini.md), Google’s assistant, as a custom app
- [Grok](https://fiveb.ar/docs/mcp/grok.md), xAI’s assistant, on the web and phones, as a custom connector
- [Perplexity](https://fiveb.ar/docs/mcp/perplexity.md), the answer engine, as a custom connector
- [Mistral Vibe](https://fiveb.ar/docs/mcp/mistral.md), formerly Le Chat, as a custom connector
- [Copilot Studio](https://fiveb.ar/docs/mcp/copilot-studio.md), Microsoft’s agent builder, for Teams and Microsoft 365 Copilot
- [Open WebUI](https://fiveb.ar/docs/mcp/open-webui.md), the self-hosted chat app, added by its admin

## Editors

- [VS Code](https://fiveb.ar/docs/mcp/vs-code.md), with GitHub Copilot, in agent mode: [add fivebar](vscode:mcp/install?%7B%22name%22%3A%22fivebar%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Ffiveb.ar%2Fapi%2Fmcp%22%7D)
- [Cursor](https://fiveb.ar/docs/mcp/cursor.md), the AI code editor: [add fivebar](cursor://anysphere.cursor-deeplink/mcp/install?name=fivebar&config=eyJ1cmwiOiJodHRwczovL2ZpdmViLmFyL2FwaS9tY3AifQ%3D%3D)
- [Devin Desktop](https://fiveb.ar/docs/mcp/devin-desktop.md), formerly Windsurf, and the Devin command line
- [Zed](https://fiveb.ar/docs/mcp/zed.md), the code editor, and its agent
- [Visual Studio](https://fiveb.ar/docs/mcp/visual-studio.md), 2022 and 2026, with GitHub Copilot: [add fivebar](https://vs-open.link/mcp-install?%7B%22name%22%3A%22fivebar%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Ffiveb.ar%2Fapi%2Fmcp%22%7D)
- [Kiro](https://fiveb.ar/docs/mcp/kiro.md), Amazon’s editor, and Kiro CLI, formerly Amazon Q Developer CLI: [add fivebar](https://kiro.dev/launch/mcp/add?name=fivebar&config=%7B%22url%22%3A%22https%3A%2F%2Ffiveb.ar%2Fapi%2Fmcp%22%7D)
- [Cline](https://fiveb.ar/docs/mcp/cline.md), the coding agent in VS Code
- [Kilo Code](https://fiveb.ar/docs/mcp/kilo-code.md), the coding agent in VS Code, and its command line

## Command line

- [Claude Code](https://fiveb.ar/docs/mcp/claude-code.md), Anthropic’s coding agent, in the terminal
- [Codex](https://fiveb.ar/docs/mcp/codex.md), OpenAI’s coding agent, and its IDE extension
- [Gemini CLI](https://fiveb.ar/docs/mcp/gemini-cli.md), Google’s agent, in the terminal
- [GitHub Copilot CLI](https://fiveb.ar/docs/mcp/copilot-cli.md), GitHub Copilot, in the terminal
- [OpenCode](https://fiveb.ar/docs/mcp/opencode.md), the open source coding agent
- [Amp](https://fiveb.ar/docs/mcp/amp.md), the coding agent from Sourcegraph
- [Factory Droid](https://fiveb.ar/docs/mcp/factory.md), Factory’s coding agent, in the terminal
- [Junie](https://fiveb.ar/docs/mcp/junie.md), JetBrains’ coding agent, in the terminal
- [Crush](https://fiveb.ar/docs/mcp/crush.md), Charm’s coding agent, in the terminal
- [Qwen Code](https://fiveb.ar/docs/mcp/qwen-code.md), Alibaba’s coding agent, in the terminal
- [Warp](https://fiveb.ar/docs/mcp/warp.md), the terminal, and its agents

## Desktop apps

- [goose](https://fiveb.ar/docs/mcp/goose.md), the open source agent, on the desktop and the command line: [add fivebar](goose://extension?url=https%3A%2F%2Ffiveb.ar%2Fapi%2Fmcp&type=streamable_http&id=fivebar&name=fivebar&description=Your%20fivebar%20stats)
- [LM Studio](https://fiveb.ar/docs/mcp/lm-studio.md), for models on your own computer: [add fivebar](lmstudio://add_mcp?name=fivebar&config=eyJ1cmwiOiJodHRwczovL2ZpdmViLmFyL2FwaS9tY3AifQ%3D%3D)
- [Raycast](https://fiveb.ar/docs/mcp/raycast.md), the launcher for Mac, and its AI
- [Cherry Studio](https://fiveb.ar/docs/mcp/cherry-studio.md), the desktop chat app for many models

## Any other app

Any app that can add a remote MCP server over Streamable HTTP, and sign in to it with OAuth, connects the same way. fivebar lets an app register itself, or identify itself with a client ID metadata document, so there’s no client ID or secret to ask for.

As of September 2026, some assistants can’t add a server of your own: the Copilot app in Windows and on the web, and Meta AI. HuggingChat can add one, but only with a key, which the MCP server doesn’t take: an [API token](https://fiveb.ar/docs/api.md) is for the stats API alone.

## What an app can read

The page the app opens names the app, as it names itself, and where it will go back to. Once you allow it, it can read the stats of every site on your Sites page, including sites you add later, and of any site whose stats are [public](https://fiveb.ar/docs/public-stats.md), when you name it. It changes nothing of yours unless you let it [change settings](#changing-settings), though it can send fivebar a note about its tools, which fivebar asks it to send only once you agree. It stays connected for 30 days, then asks again.

What fivebar keeps about the apps you connect and the notes they send, and for how long, is in the [privacy policy](https://fiveb.ar/privacy/index.md), which the app can read for you if you ask it.

## What it can do

- `list_sites`: your sites, with their groups and time zones, or one group’s alone.
- `get_overview`: every one of your sites, or one group’s, in one go: each one’s pageviews, visits and visitors beside the period before, the ones that moved most clearly first.
- `get_site_summary`: a site’s figures over a range, beside the period before: pageviews, visits, visitors, bounce rate and visit duration, with its top channels, sources, pages and countries. In an app that draws views, such as Claude, ChatGPT or VS Code, you see them as the dashboard’s tiles and chart too; the app may ask you once whether to show them.
- `get_site_breakdown`: one of a site’s panes in full, such as its channels, sources, pages, networks, campaigns, goals or [site searches](https://fiveb.ar/docs/site-search.md), or the data an event goal was sent with.
- `explain_change`: why a site’s visits went up or down: the channels, sources, pages, countries and the rest that moved most beyond the site as a whole, with what is too small to read into marked as such.
- `whats_new`: what changed on a site, found by fixed rules, the most pressing first: server errors, pages newly answering with errors or turning slow, goals no longer reached, sources, countries and pages that took off or fell away, and sources, referrers, campaigns and pages that are new.
- `list_goals`: a site’s goals, and the first and last days each was reached.
- `get_site_hours`: when a site’s visitors come, by the hour of the day and the day of the week.
- `get_site_speed`: how fast a site’s pages were, as its Speed page has it, beside the period before.
- `get_site_engagement`: how long pages were on screen and how far down they were read, beside the period before.
- `get_site_bots`: the pageviews taken for [bots](https://fiveb.ar/docs/bots.md), as a site’s Bots page has them, beside the period before: why each was taken for one, which known bot it said it was, and its pages, sources, networks and countries. No other tool’s figures count them.
- `get_live_visitors`: how many are on a site now.
- `get_site_setup`: how one of your sites is set up: its tracking code, time zone, group, email reports, the traffic it excludes and its search rules, so an app in your editor can [install fivebar for you](https://fiveb.ar/docs/coding-assistants.md).
- `check_install`: whether fivebar is working on one of your sites: the tag on its home page, what its Content Security Policy lets through, and what it has counted.
- `read_docs`: fivebar’s docs, as Markdown, and how fivebar counts, so an app can explain a figure in fivebar’s own words.
- `search_docs`: the parts of fivebar’s docs that hold some words, found as [the docs’ search](https://fiveb.ar/docs/search.md) finds them, so an app knows which page to read.
- `send_feedback`: a note to fivebar about something the tools couldn’t answer, or answered wrong, which fivebar asks the app to send only once you’ve seen it and agreed.

The tools that read figures take a range and filters as the dashboard does, and every answer tells the app which of fivebar’s rules apply to it: that visitors are visitor-days, say, or that today isn’t over. Ask what you’d ask the dashboard: how last week compared with the week before, where this month’s sign-ups came from, how many visits came from ChatGPT and the other [AI Assistants](https://fiveb.ar/docs/sources-and-campaigns.md#channels), or which hours to run an ad in. Or ask how all your sites did last week, why one moved, and what’s new on it.

## Changing settings

The page the app opens has a box, **Also let it change settings**, which is unticked whatever the app asks for. Leave it unticked and the app changes nothing of yours. Tick it and the app can also change these settings of the sites you hold:

- `add_goal`: adds a [page goal](https://fiveb.ar/docs/goals.md#page-goals), counted from then on.
- `remove_goal`: removes a page goal and deletes everything it counted, which fivebar asks the app to do only once you’ve agreed.
- `hide_goal`: hides a goal from the dashboard, still counting it, or shows it again.
- `add_search_rule`: tells fivebar where a site keeps its [searches](https://fiveb.ar/docs/site-search.md#setting-it-up-with-a-rule), so they’re counted from then on.
- `remove_search_rule`: stops counting a rule’s searches, keeping what it counted.
- `exclude_traffic`: [leaves out](https://fiveb.ar/docs/excluding-traffic.md) an address or range, a network or a country from every count, from then on.
- `include_traffic`: counts again what was excluded, from then on.
- `set_time_zone`: the [time zone](https://fiveb.ar/docs/sites.md#time-zone) a site counts its days in.
- `move_to_group`: the [group](https://fiveb.ar/docs/sites.md#group) a site is listed in on Sites.

Ask for a change in your own words, such as “add a goal for my thanks page”. fivebar asks the app to make one only when you ask for it, and most apps show you each change before making it. An app can’t change a site it reads only because its stats are public, and it never makes a site’s stats public or private, changes your email reports or deletes a site: those stay on the site’s settings page.

An app connected with the box unticked stays that way. To let it change settings, connect it again from the app and tick the box. [Settings](https://fiveb.ar/settings) says “can change settings” under the name of an app that can. To take that away, disconnect it there and connect it again, leaving the box unticked.

## Ready-made questions

fivebar also gives apps five questions to start from, which MCP calls prompts. Each asks the app for the tools that answer it, and for the rules that change what a figure means:

- **Weekly report**, `weekly_report`: how your sites did last week against the week before, and what drove each change. Name a site to hear about that one alone.
- **What changed**, `what_changed`: why a site’s traffic went up or down, and whether the change is more than noise, over the 7 days to yesterday or a range you name.
- **Check install**, `check_install`: whether fivebar is working on a site, and what to fix first.
- **AI traffic**, `ai_traffic`: how many visits ChatGPT, Claude, Perplexity and the other AI assistants sent your sites, or one of them, over the last 30 days or a range you name.
- **Campaign report**, `campaign_report`: how a campaign’s tagged links did on a site, or, with no campaign named, its campaigns to choose from.

Name a site by its domain, and a range as an address writes it, such as `last-month`: see [Date ranges](https://fiveb.ar/docs/date-ranges.md#the-ranges). Where you find the questions depends on the app. In Claude Code, type `/` to see them listed, such as `/fivebar:weekly_report`, or type one with what it needs after it, such as `/mcp__fivebar__what_changed example.com last-month`. In VS Code’s chat, type `/mcp.fivebar.weekly_report`, and it asks for anything the question needs. In Claude, choose + in the message box, then Connectors and fivebar. In an app that doesn’t offer them, ask in your own words.

## A report every week

Some apps can ask for you on a schedule. In Claude, on a paid plan, say what to ask and how often, such as “Every Monday at 9am, use fivebar to tell me how my sites did last week”, and choose **Schedule** when it shows you the task. It runs with your connectors, even while your computer is asleep: see Claude’s guide to [scheduled tasks](https://support.claude.com/en/articles/13854387-schedule-recurring-tasks-in-claude-cowork). Claude Code’s [routines](https://code.claude.com/docs/en/routines) can too, with fivebar added as a connector in Claude rather than with `claude mcp add`.

fivebar can also email you a site’s stats itself, every week, every month or both: see [Email reports](https://fiveb.ar/docs/email-reports.md).

## Disconnecting

Your connected apps are listed in [Settings](https://fiveb.ar/settings), with when each was connected and when its access ends. Disconnect one there and it loses access within a minute. Signing out of fivebar leaves your apps connected.
