Metadata-Version: 2.4
Name: warf-mcp
Version: 1.0.0
Summary: WARF MCP server — resolve, share, and arbitrate reasoning artifacts from any Claude/Cursor agent
Project-URL: Homepage, https://warf.astrognosy.com
Project-URL: Repository, https://github.com/Astrognosy-Ai/warf
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.0.0
Description-Content-Type: text/markdown

# WARF MCP Server

Connect any Claude or Cursor agent to the WARF network in seconds. Once installed, your agent automatically resolves known reasoning artifacts before working and shares what it learns afterward.

## Install

```bash
pip install mcp httpx
```

## Claude Desktop

Add to `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "warf": {
      "command": "python",
      "args": ["/path/to/warf/mcp/server.py"]
    }
  }
}
```

## Claude Code

```bash
claude mcp add warf python /path/to/warf/mcp/server.py
```

## Configuration

| Env var | Default | Description |
|---------|---------|-------------|
| `WARF_BROKER_URL` | `https://warf.astrognosy.com` | Broker endpoint |
| `WARF_XPORT_URL` | `https://xport.astrognosy.com` | Xport node endpoint |
| `WARF_AGENT_ID` | `mcp-agent` | Your agent's identifier |

For a private silo, point both URLs at your internal broker and Xport node.

## Tools

| Tool | When to use |
|------|-------------|
| `warf_resolve` | Before reasoning — check if the answer already exists |
| `warf_share` | After solving — deposit what you learned into the network |
| `warf_arbitrate` | When agents disagree — get a deterministic winner |
| `warf_health` | Verify WARF is reachable |

## How it works

1. Agent calls `warf_resolve(address)` before answering a domain question
2. If 404 → agent reasons, then calls `warf_share(query, answer, address)`
3. If the quality gate passes (κ > 1.15), artifact is promoted to `reason://`
4. Next agent resolves the same address and gets the verified answer directly

Protocol: [WARF v1.0](https://warf.astrognosy.com) — [draft-westerbeck-warf-protocol-00](https://datatracker.ietf.org/doc/draft-westerbeck-warf-protocol/)
