# CommunityFix

> CommunityFix is an open-source, community-driven platform where anyone can propose global challenges, submit solutions, and document real-world implementations as case studies. It combines collaborative problem-solving with a startup incubation model to turn ideas into sustainable ventures.

The platform organizes knowledge as a tree: issues (problems) contain sub-issues and solutions; solutions contain case studies documenting where and how they were tried. Users can vote, endorse qualifications, and collaborate across disciplines.

CommunityFix exposes an MCP (Model Context Protocol) server so AI assistants can search, browse, and contribute issues and solutions on behalf of authenticated users.

## Docs

- [Whitepaper](https://communityfix.org/whitepaper): Vision, problem statement, incubation model, governance, and sustainability metrics
- [Authoring Guide](https://communityfix.org/guide/authoring): Instructions for contributing high-quality issues, solutions, and case studies, for humans and AI agents
- [MCP Server](https://communityfix.org/mcp): How to connect Claude Desktop, Claude Code, and other AI clients via the Model Context Protocol
- [Privacy Policy](https://communityfix.org/privacy): Data handling and privacy practices
- [Terms of Service](https://communityfix.org/terms): Platform terms and conditions

## API

AI clients that speak the Model Context Protocol should use the MCP endpoint — it is the richest interface and supports authenticated writes. Clients that cannot speak MCP can still read the public catalog over plain HTTP `GET`: every REST endpoint below returns JSON, needs no authentication, and takes `{id}` as a numeric node id (or UUID for users). Creating or editing content is only available through MCP or the web app.

- [MCP Endpoint](https://communityfix.org/api/mcp): Model Context Protocol JSON-RPC endpoint for AI clients (OAuth 2.1 + PKCE required)
- [List issues](https://communityfix.org/api/issues): Browse top-level issues. Query params: `search` (full-text), `tag` (slug), `sort` (`most_voted` default, `trending`, `oldest`), and `lat`/`lng`/`radius` (km) for geographic filtering
- [Search catalog](https://communityfix.org/api/search): Semantic (meaning-based) search across both issues and solutions. Query params: `query` (required, ≥3 chars), `type` (`issue`/`solution`/`any`), `limit`
- [List by tag or SDG](https://communityfix.org/api/nodes): List issues and solutions filtered by `tag` slug and/or `sdg` id (at least one required). Query params: `tag`, `sdg`, `type`, `sort`, `limit`
- [Nearby](https://communityfix.org/api/nearby): Issues, solutions and case studies near a point, nearest-first. Query params: `lat`, `lng` (required), `radius` (km), `kind`, `limit`
- [Discover case studies](https://communityfix.org/api/case-studies): Search and filter case studies across the whole catalog. Query params: `query` (semantic), `outcome`, `scale`, `verified`, `limit`
- [Get node](https://communityfix.org/api/issue/{id}): Fetch a single issue or solution by numeric id
- [Get tree](https://communityfix.org/api/issue/{id}/tree): Full descendant tree of an issue — sub-issues and solutions, with approved case studies attached
- [List sub-issues](https://communityfix.org/api/issue/{id}/issues): Direct sub-issues of an issue
- [List solutions](https://communityfix.org/api/issue/{id}/solutions): Proposed solutions for an issue
- [List case studies](https://communityfix.org/api/issue/{id}/case-studies): Case studies aggregated under an issue and its solutions
- [Get case study](https://communityfix.org/api/case-study/{id}): Fetch a single case study by numeric id
- [Find similar issues](https://communityfix.org/api/issues/similar): Semantic nearest-neighbour lookup before creating an issue. Query params: `title`, `summary`
- [List tags](https://communityfix.org/api/tags): The full tag taxonomy
- [List SDGs](https://communityfix.org/api/sdgs): UN Sustainable Development Goals used for classification
- [Get user](https://communityfix.org/api/user/{id}): Public profile of a user by UUID

## MCP Tools

- search_issues_solutions: Semantic vector search across all issues and solutions
- get_issue: Fetch a single issue or solution by ID
- get_tree: Get full tree of an issue with all descendants
- create_issue: Create a new issue (top-level or sub-issue)
- create_solution: Create a solution for an issue (requires parentId)
- update_issue: Update an existing issue
- update_solution: Update an existing solution
- create_case_study: Document a real-world implementation of a solution
- get_case_study: Fetch a case study by ID
- list_case_studies: List all case studies for a solution
- update_case_study: Modify a case study
- suggest_more: Get semantically similar issues or solutions
- search_tags: Search the tag taxonomy
- get_user: Fetch a user profile
- whoami: Get the authenticated user's profile
- get_whitepaper: Read the platform whitepaper (mission, incubation model, governance, impact metrics)
- get_guide: Read the authoring guide; omit the slug to list available guides, pass one (e.g. "authoring") for the full text
- propose_edit: Propose a change to any issue, solution, or case study — applies live if you own it, otherwise queued as a revision proposal
- list_revisions: List a node's revision history plus any pending proposals you may see
- review_revision: Approve or reject a pending revision proposal on a node you own

## Optional

- [Source Code](https://github.com/mathix420/communityfix): Open-source Nuxt 4 codebase on GitHub
- [Issue Catalog](https://communityfix.org): Browse and search global challenges and proposed solutions