io.hunchful/hunchful
Read and grow a person's falsifiable, consent-based model of how they work with AI (CMP).
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
claude mcp add --transport http hunchful 'https://hunchful.io/mcp'{
"mcpServers": {
"hunchful": {
"type": "http",
"url": "https://hunchful.io/mcp"
}
}
}التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
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/fetchnever 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).
الأسئلة الشائعة
ما هو io.hunchful/hunchful؟
Read and grow a person's falsifiable, consent-based model of how they work with AI (CMP).
كيف أثبّت io.hunchful/hunchful؟
يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http hunchful 'https://hunchful.io/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج io.hunchful/hunchful إلى مفتاح API؟
لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.
هل io.hunchful/hunchful مفتوح المصدر؟
شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.
من يصون io.hunchful/hunchful؟
ينشره filinils. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.