# hunchful MCP server

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

## Links
- Registry page: https://www.getdrio.com/mcp/io-hunchful-hunchful
- Repository: https://github.com/filinils/hunchful-mcp
- Website: https://hunchful.io

## Install
- Endpoint: https://hunchful.io/mcp
- Auth: Not captured

## Setup notes
- Remote endpoint: https://hunchful.io/mcp

## Tools
- read_model - Read a Hunchful collaboration model: its hunches (axis, pole, confidence), the axis ids you can refine, and how you're connected. Start here. With OAuth, omit modelId to read the connected person's own model. Endpoint: https://hunchful.io/mcp
- propose_refinement - Propose a refinement (provenance pointers only). It lands in the owner's confirm queue — nothing changes until they accept. Authorized by OAuth (own model) or a contributionToken. Endpoint: https://hunchful.io/mcp
- suggest_question - Suggest a NEW question/axis for the person — a dimension their model doesn't capture (situational axes welcome: name it 'When <situation>'). It lands in their Hunchful inbox and, by default, emails them; nothing is added until they answer. Authorized by OAuth (own model) or a contributionToken. Use sparingly — about once a week at most. Endpoint: https://hunchful.io/mcp
- add_hunch - Record a NEW hunch the person just confirmed in conversation — a custom axis with their answer, added directly to their model (visible, revisable, removable by them). OWNER-LEVEL trust required: OAuth as the owner, or the editToken. Only record what the person actually said — never invent or infer a hunch they didn't confirm. For situational axes name it 'When <situation>'. If they haven't answered yet, use suggest_question instead. Endpoint: https://hunchful.io/mcp
- find_complementary_thinkers - Which famous thinkers would COMPLETE this person — opposite poles on the axes where opposites unstick each other (not similarity). Open read; great for curiosity and for explaining what a complementary collaborator looks like. Share the pages as links. Endpoint: https://hunchful.io/mcp
- find_matches - Look for complementary PEOPLE for the connected person (rule: agents propose, humans accept — this creates pending proposals the human decides on in their Hunchful hub; identities are never revealed here). Requires OAuth as the owner or the model's editToken, and the person must have joined introductions on their matches page. Endpoint: https://hunchful.io/mcp
- apply_refinement - Apply a refinement directly as one logged revision (append evidence pointers, nudge confidence). Authorized by OAuth (own model) or an editToken. Prefer propose_refinement unless the owner asked for direct writes. Endpoint: https://hunchful.io/mcp

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: io.hunchful
- Version: 1.0.0
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jul 4, 2026
- Source: https://registry.modelcontextprotocol.io