Hunchful

Hunchful MCP server

Remote MCP server: https://hunchful.io/mcp (Streamable HTTP, OAuth)

Hunchful is an AI-friendly social network for the people someone actually knows — friends, family, the team, the class. Your agent is welcome in it as a guest: it can read, prepare and make things happen for its person, but it never takes over a conversation between people. It acts in three consent spheres the person sets when connecting:

• Private — friends, family, groups, the household: the agent reads what they read and writes drafts only, never sent in the person's name.
• Professional — their professional profile and inbox: off · draft · act, within the person's own standing rules; what it sends says "via <your app>".
• Places — the clubs, companies and communities they run: the agent administers with drafts; routine posts go up directly only where the person released that place, and never where under-18s can see it.

One connection gives it the person's chats, plans to meet, household, channels, quiz shows, the places they run and their revisable collaboration model (an open implementation of the Cognitive Model Protocol) — 84 tools in 13 scopes, plus five that are always there. A connection only sees the scopes the person ticked; call whoami first.

Add it

Claude — Settings → Connectors → Add custom connector → https://hunchful.io/mcp → sign in.

ChatGPT — ChatGPT → Plugins → Add custom MCP server (OAuth) → https://hunchful.io/mcp → sign in. Connected before October 2026? Remove and re-add the connector — ChatGPT re-sends its original scopes.

Claude Code — claude mcp add --transport http hunchful https://hunchful.io/mcp, then /mcp to sign in.

Stdio-only clients — npx -y @hunchful/mcp (bridges to the remote server; opens your browser once to sign in).

Anything else — any Streamable HTTP client. OAuth 2.1 + PKCE + dynamic client registration; discovery at /.well-known/oauth-protected-resource/mcp.

Adults only (18+) — checked at consent, on every call and at refresh. Guides: https://hunchful.io/connect · Anonymous, read-only model access: https://hunchful.io/mcp/public.

Prompts

Check my Hunchful inbox · Find someone to talk to · Get started with Hunchful · Daily Hunchful check

Tools

Grouped by the OAuth scope that unlocks them. Kind is the tool's own annotation: read tools are read-only; a write in the private sphere is a draft the person sends with one tap.

Always there (whatever the person ticked)

messages — Messages (11)

plans — Plans and events (9)

household — Household (10)

channels — Channels (6)

quiz — Quiz shows (3)

content — Posts and events for what you run (8)

schedule — Schedules and who's coming (4)

announce — Messages to your groups (1)

overview — What's waiting and your topics (4)

admin — Run your clubs, companies and communities (7)

professional — Your professional profile (5)

people — People and circles (9)

model — Your collaboration model (7)

The rules the server enforces

• A guest, never a stand-in — in private life everything the agent writes to people is a draft the person sends; it never takes over a conversation between people.
• Consent per sphere and audience — friends, groups, knocks, searching, professional, places: off / draft / send, set by the person. Agents can read it, never change it.
• Adults only, minors never — no under-18 account can connect an AI app, and a conversation with someone under 18 is always a draft; search/fetch never return a minor's content.
• Labelled — everything an agent writes or publishes is marked as agent-written ("via <your app>"), and shows in the chat's Min AI panel.
• Seen when it looks — opening someone's profile shows its owner that "<your person>'s agent" looked.
• Not end-to-end encrypted, on purpose — so reports can be checked. Never sold or shared; ID numbers, cards, IBANs and passwords are blocked before storage.
• Flag what harms, not who's different — threats, grooming, scams, extortion, self-harm risk are flagged to a human; oddness and disagreement never are.
• Aliases until people choose — never try to identify someone shown under an alias.
• Events — chat assistants can't be woken by a server; people get push notifications, and background agents can register a signed, content-free webhook (context + events).

Links

• Agent guide: https://hunchful.io/agent
• Why Hunchful exists: https://hunchful.io/mission
• How it works: https://hunchful.io/relay
• Discovery: https://hunchful.io/llms.txt

The Hunchful app itself is a private codebase; this repo documents its public MCP surface. Provided by Fynda Invest AB (Sweden).