About Osboon
Osboon is a read-only MCP server for querying analytics and profile data from an Osboon account. It is intended for people managing digital business cards who want to inspect visits, viewers, links, connections and contact channels through an AI assistant.
Key features
- 01View card visit analytics
- 02Compare card performance by visits
- 03List viewers with privacy-limited details
- 04Retrieve card URLs and slugs
- 05Read connections and contact channels
- 06Browse supported languages
Use cases
- 01Check visits over a selected period
- 02Identify the most-viewed card
- 03Review viewer locations and devices
- 04Retrieve profile contact details
MCP support
Exposes seven read-only tools to MCP clients through a hosted Streamable HTTP server. Authentication uses OAuth 2.1 with browser-based sign-in and approval.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://osboon.com/mcp/claude mcp add --transport http com-osboon-osboon https://osboon.com/mcp/{"mcpServers":{"com-osboon-osboon":{"type":"http","url":"https://osboon.com/mcp/"}}}Open in Cursor{"servers":{"com-osboon-osboon":{"type":"http","url":"https://osboon.com/mcp/"}}}Open in VS Code{"mcpServers":{"com-osboon-osboon":{"type":"http","url":"https://osboon.com/mcp/"}}}{"mcpServers":{"com-osboon-osboon":{"serverUrl":"https://osboon.com/mcp/"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
Details
From the project READMEOsboon MCP Server
Connect your AI assistant to your Osboon account and ask questions about your own digital business cards in plain language — "How many visits did my card get this week?", "Who viewed it, and from where?", "Which of my cards performs best?". Read-only, free, and you can disconnect at any time.
Server address:
https://osboon.com/mcp/
- Transport: Streamable HTTP (remote server — nothing to install or run)
- Auth: OAuth 2.1 — authorization code + PKCE, with dynamic client registration and automatic discovery. You sign in on osboon.com; your password never touches the assistant.
- Access: read-only, 7 tools, free with any Osboon account
Connect
Full step-by-step guides for every supported client, with screenshots: osboon.com/mcp/connect
Chat apps (Claude, Mistral Le Chat, and other MCP-capable assistants): add a custom connector and paste the server address above — the guide covers each one.
CLI / dev tools:
# Claude Code
claude mcp add --transport http osboon https://osboon.com/mcp/
# Codex CLI
codex mcp add osboon --url https://osboon.com/mcp/
Generic MCP client config (VS Code with GitHub Copilot, Cursor, Zed, Goose, LM Studio, Warp, Gemini CLI, Qwen Code CLI, …):
{
"mcpServers": {
"osboon": {
"type": "http",
"url": "https://osboon.com/mcp/"
}
}
}
Your client opens a browser window to osboon.com, you sign in and approve, and the tools appear. About two minutes, once.
Tools (7, all read-only)
| Tool | What it answers |
|---|---|
get_card_analytics | Visitor counts for your cards over today / 7 days / 30 days |
compare_card_analytics | Ranks your cards by visits over a range and names the best performer |
list_card_viewers | Who viewed your cards — country, city, device type, time (privacy-floored) |
get_card_link | The public URL and slug for one of your cards |
get_my_connections | Your active network connections (people and companies) |
get_my_contact_channels | The contact channels on your own profile (email, phone, website, …) |
get_languages | Reference list of the languages Osboon supports |
Security & privacy
- Read-only. No tool can create, change, or delete anything on your account.
- Your password never reaches the assistant. Sign-in and consent happen on osboon.com (OAuth 2.1); the assistant only ever holds a scoped token.
- Scoped tokens. Access is split into
analytics:read,contact:read,profile:read, andcard:read— a token carries only what it needs. - Viewer data is dashboard-grade only.
list_card_viewersreturns the same fields your own dashboard shows — country, city, device type, visit time — never IP addresses or user agents. Ranges with fewer visits than the privacy floor return only a count, no rows. - Disconnect any time. On osboon.com: Settings → Security → Agents. Or remove the connector in your AI client — either side kills the access.
Links
- Setup guides & FAQ: osboon.com/mcp/connect
- Osboon: osboon.com
- Terms: osboon.com/eula
This repository is documentation for the hosted Osboon MCP server; the server itself is not open source.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.