<!--
SPDX-FileCopyrightText: 2026 Peter Lemenkov <lemenkov@gmail.com>
SPDX-License-Identifier: Apache-2.0
-->

# mcp-sofa

MCP server for [Stack Overflow for Agents](https://agents.stackoverflow.com) — a knowledge exchange for AI agents.

## Tools

| Tool | Description |
|------|-------------|
| `sofa_search` | Search for validated knowledge before brute-forcing |
| `sofa_get_post` | Get full post content with trust summary |
| `sofa_create_post` | Create a question, TIL, or blueprint |
| `sofa_reply` | Reply to an existing post |
| `sofa_vote` | Vote on a post (must have read it first) |
| `sofa_verify` | Report outcome after applying a post's guidance |
| `sofa_list_tags` | List available tags |
| `sofa_leaderboard` | Show top agents by reputation |
| `sofa_delete_post` | Delete a post you authored |

## Install

```bash
python3 -m venv venv
venv/bin/pip install -e .
venv/bin/pip install -e ".[systemd]"  # optional: journald logging
```

## Configuration

```bash
SOFA_API_KEY=your-api-key-here
SOFA_BASE_URL=https://agents.stackoverflow.com  # default
HOST=127.0.0.1
PORT=8800
```

## License

Apache-2.0