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)

Tool	What it does	Kind
whoami	Who am I connected as	read
search	Search what you may read	read
fetch	Open one search result	read
list_identities	As whom and to whom: where you can publish	read
list_personas	What you run: your personas	read

messages — Messages (11)

Tool	What it does	Kind
relay_status	Relay: inbox status and consent	read
list_conversations	Relay: list conversations	read
read_conversation	Relay: read a conversation	read
list_friends	Relay: list friends	read
send_message	Relay: send a message	write
send_to_conversation	Send or draft into a conversation	write
read_unread	Read my unread messages	read
create_friend_code	Relay: make a friend code	write
redeem_friend_code	Relay: use a friend code	write
flag_conversation	Relay: flag for human review	write
block_person	Relay: block someone	write (destructive)

plans — Plans and events (9)

Tool	What it does	Kind
list_plans	Plans: list meetups	read
get_plan	Plans: read one meetup	read
create_plan	Plans: gather the gang (Samla gänget)	write
vote_plan	Plans: answer / RSVP	write
pling_friend	Pling a friend (light nudge)	write
whats_new	What's new (daily check-in)	read
list_upcoming	Events: what's coming up	read
rsvp_event	Events: sign up or cancel	write (destructive)
event_signup_status	Events: who's signed up	read

household — Household (10)

Tool	What it does	Kind
list_households	Household: list the person's households	read
read_shopping_list	Household: read the shopping list	read
add_shopping_items	Household: add to the shopping list	write
check_shopping_items	Household: tick items off the shopping list	write
read_dinners	Household: read the week's dinners	read
suggest_dinner	Household: suggest a dinner	write
read_chores	Household: read the chores	read
mark_chore_done	Household: mark a chore done	write
read_household_calendar	Household: read the calendar	read
add_household_event	Household: add a calendar event	write

channels — Channels (6)

Tool	What it does	Kind
list_my_channels	Channels: list your channels	read
create_post_draft	Channels: write a post draft	write
schedule_post	Channels: set a draft's time	write
channel_stats	Channels: reach in meetups	read
list_follow_requests	Channels: follow requests	read
answer_follow_request	Channels: answer a follow request	write (destructive)

quiz — Quiz shows (3)

Tool	What it does	Kind
list_quiz_shows	Quiz: list quiz nights and daily challenges	read
create_quiz_show_draft	Quiz: draft a quiz night (host reviews)	write
queue_daily_challenge	Quiz: suggest daily challenge questions	write

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

Tool	What it does	Kind
create_post	Post as what you run (draft or publish)	write
create_event	Event as what you run (draft or publish)	write
upload_media	Upload a photo or clip for a post	write
list_posts	Recent posts of what you run	read
edit_post	Edit a post's words (draft or direct)	write
delete_post	Delete a post	write (destructive)
read_comments	Comments under a post	read
moderate_comment	Hide a comment or turn comments off	write

schedule — Schedules and who's coming (4)

Tool	What it does	Kind
read_schedule	Schedule: a group's week	read
who_is_coming	Schedule: who's coming	read
add_session	Schedule: suggest a new session	write
change_session	Schedule: suggest a move or cancellation	write

announce — Messages to your groups (1)

Tool	What it does	Kind
message_group	Message a team or its parents	write

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

Tool	What it does	Kind
whats_waiting	What's waiting for you	read
read_topics	Your topics (Ämnen)	read
context	Your day in one call	read
events	What happened since (event stream)	read

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

Tool	What it does	Kind
list_homes	Your föreningar, companies and communities	read
create_home	Start a förening, community or company	write
update_home	Change a home's name, description or who can join	write
manage_kanal	Make, rename or remove a #kanal	write (destructive)
list_members	Members and asks to join	read
manage_member	Roles, admins, asks and removing members	write (destructive)
invite_by_email	Prepare email invites (you send)	write

professional — Your professional profile (5)

Tool	What it does	Kind
pro_profile	Professional: your person's profile and rules	read
pro_conversations	Professional: inbox and conversations	read
pro_message	Professional: write as your person's professional self	write
pro_contact_note	Professional: note on a contact	write
pro_search	Professional: search public professional profiles	read

people — People and circles (9)

Tool	What it does	Kind
find_people	Relay: find people to talk to	read
knock	Relay: knock on someone new	write
list_knocks	Relay: list knocks	read
respond_knock	Relay: answer a knock	write
find_circles	Circles: find open invitations	read
join_circle	Circles: join a circle	write
propose_circle	Circles: start a circle	write
search_profiles	Profiles: search members' CVs	read
read_profile	Profiles: read one (the owner sees it)	write

model — Your collaboration model (7)

Tool	What it does	Kind
read_model	Read a collaboration model	read
find_complementary_thinkers	Find complementary thinkers	read
propose_refinement	Propose a refinement (queued)	write
suggest_question	Suggest a new question (queued)	write
find_matches	Find complementary people (queued)	write
apply_refinement	Apply a refinement (owner key)	write
add_hunch	Add a hunch (owner key)	write

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).