Hunchful

io.hunchfulPublished by hunchful.ioOfficial publisherv1.0.0Updated Oct 24, 2026

Read and grow a person's falsifiable, consent-based model of how they work with AI (CMP).

VerifiedStreamable HTTPWeb executableProductivity & Workflow Knowledge & Memory Communication & Collaboration

Server details

Identifier: io.hunchful/hunchful
Transport: Streamable HTTP
Runtime: Web executable
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified that this server's namespace belongs to hunchful.io, which also runs its endpoint. That identifies the publisher; it does not make the server's tools safe.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.hunchful%2Fhunchful.svg)](https://sourceweft.com/mcp/io.hunchful%2Fhunchful?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Remote MCP server for Hunchful, an AI-friendly social network, letting an assistant read chats, plans, households and channels and prepare drafts within…

What you can do: Identify the connection and search or open readable content, list identities and personas
Read and draft messages, conversations, friends, unread items, friend codes, blocks and flags
Handle plans, events, RSVPs, nudges and daily check-ins
Work with households: shopping lists, dinners, chores and shared calendar
Draft, schedule and moderate channel posts, quiz shows, events and comments
Administer clubs, companies and communities, manage members and prepare email invites
When to use it: For people who use Hunchful and want their assistant to help with everyday social and group admin: catching up on messages, drafting replies, organising meetups, household tasks, or running a club's posts and events, within the consent spheres they set.
Requirements: Remote Streamable HTTP endpoint with OAuth 2.1 sign-in; no API keys or environment variables. Stdio-only clients can bridge through an npm package that opens a browser to sign in. An adult (18+) Hunchful account is required.

Before you install

Many tools write: sending messages, RSVPs, posts, member and channel changes, deletions and blocks. Private-sphere writes are drafts the person sends, but professional and places scopes can send or publish directly, labelled as agent-written. Opening a profile is visible to its owner. Content is not end-to-end encrypted, and the connection sees only the scopes the person ticked.

Installation

In SourceWeft

Open Hunchful in the dashboard and add it to a workspace.
Connect the required credentials. They are stored privately and never shown on public pages.
Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.hunchful%2Fhunchful/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "hunchful": {
      "type": "http",
      "url": "https://hunchful.io/mcp"
    }
  }
}

README

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)

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

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

Tools

This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

v1.0.0LatestSep 16, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 daysRequired25 pts
Auth declaredRequired10 pts
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts
Declare a license in the repository or the registry entry.

Hunchful

Overview

Installation

In SourceWeft

Use with an agent

Other MCP clients

README

Hunchful MCP server

Add it

Prompts

Tools

The rules the server enforces

Links

Tools

Version history

Score