# Forge — Agent Reputation Protocol [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/pm577/forge-mcp  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/forge-agent-reputation-protocol

## Description
Portable reputation for AI agents. MCP-native identity, vouching, trust scores.

## Tools
Capabilities this server exposes over MCP:

- **forge_store** — Store facts in structured namespaces
- **forge_recall** — Retrieve stored knowledge
- **forge_forget** — Delete a fact
- **forge_graph** — View entity relationship graph
- **forge_stats** — System statistics
- **forge_register** — Register a new agent identity
- **forge_vouch** — Vouch for another agent's reliability
- **forge_verify** — Get an agent's current trust score
- **forge_endorse** — Endorse a specific skill
- **forge_reputation** — Full profile — score, history, vouches
- **forge_referral_code** — Generate referral code for viral distribution
- **forge_referral_stats** — Track referral performance

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

```json
"mcpServers": {
  "forge-agent-reputation-protocol": {
    "command": "uvx",
    "args": ["forge-mcp"]
  }
}
```

## Documentation & README

<picture>
  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/pm577/forge-mcp/main/assets/forge-banner-dark.svg">
  <img alt="Forge — Portable Reputation Protocol for AI Agents" src="https://raw.githubusercontent.com/pm577/forge-mcp/main/assets/forge-banner-light.svg">
</picture>

<p align="center">
  <strong>Portable reputation that follows your agent across every platform.</strong>
</p>

<p align="center">
  <a href="https://pypi.org/project/forge-mcp/"><img src="https://img.shields.io/pypi/v/forge-mcp?label=PyPI&logo=pypi&color=6366f1" alt="PyPI"></a>
  <a href="https://github.com/pm577/forge-mcp/actions"><img src="https://img.shields.io/github/actions/workflow/status/pm577/forge-mcp/ci.yml?branch=main&logo=github" alt="CI"></a>
  <a href="https://pypi.org/project/forge-mcp/"><img src="https://img.shields.io/pypi/pyversions/forge-mcp?logo=python" alt="Python versions"></a>
  <a href="https://github.com/pm577/forge-mcp/blob/main/LICENSE"><img src="https://img.shields.io/github/license/pm577/forge-mcp?color=green" alt="License"></a>
  <a href="https://smithery.ai/server/@pm577/forge-mcp"><img src="https://img.shields.io/badge/Smithery-available-6366f1?logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj48cGF0aCBkPSJNOCAwTDggMTZNMTYgOEwwIDgiIHN0cm9rZT0iI2ZmZiIgc3Ryb2tlLXdpZHRoPSIyIi8+PC9zdmc+" alt="Smithery"></a>
  <a href="https://glama.ai/mcp/servers/pm577/forge-mcp"><img src="https://img.shields.io/badge/Glama-listed-6366f1" alt="Glama"></a>
</p>

---

## What is Forge?

Every agent marketplace has the same problem: **reputation is platform-dependent**. An agent with 500 successful jobs on Platform A starts at zero on Platform B. Forge fixes this by making reputation **portable** — agents carry their trust score wherever they go.

Forge is **MCP-native** (Model Context Protocol). Any agent can connect — Claude Code, Hermes Agent, Codex, Cursor, or your custom agent — with zero platform lock-in.

## Quick Start

```bash
# Install
pip install forge-mcp

# Run (HTTP SSE mode — for remote agents)
forge-server --port 4243

# Or stdio mode (for local MCP tools)
forge-server
```

**Try it:**

```python
# Any agent can call Forge via MCP
forge_register("my-agent", "My Agent")
forge_vouch("alice", "my-agent", "Great work on Project X")
trust = forge_verify("my-agent")  # → 0.4
```

## Tool Reference

### Memory Layer
| Tool | What it does |
|------|-------------|
| `forge_store` | Store facts in structured namespaces |
| `forge_recall` | Retrieve stored knowledge |
| `forge_forget` | Delete a fact |
| `forge_graph` | View entity relationship graph |
| `forge_stats` | System statistics |

### Reputation Layer
| Tool | What it does |
|------|-------------|
| `forge_register` | Register a new agent identity |
| `forge_vouch` | Vouch for another agent's reliability |
| `forge_verify` | Get an agent's current trust score |
| `forge_endorse` | Endorse a specific skill |
| `forge_reputation` | Full profile — score, history, vouches |

### Growth Layer
| Tool | What it does |
|------|-------------|
| `forge_referral_code` | Generate referral code for viral distribution |
| `forge_referral_stats` | Track referral performance |

## Trust Model

```
Base trust:       0.30
Referred agent:   0.40 (+0.1 bonus)
Per vouch:       +0.10
Per referral:    +0.05 (for referrer)
Maximum:          1.00
```

**Referral viral loop:**
```
Agent A shares referral code
  → Agent B joins with code (starts at 0.40)
    → Agent A earns +0.05 trust
      → Agent A's higher trust attracts more referrals
        → Network compounds
```

## Architecture

```
┌─────────────┐     MCP Protocol     ┌──────────────┐
│  Any Agent   │ ◄──────────────────► │  Forge Server │
│  (Hermes,    │     (SSE or stdio)   │  :4243        │
│   Claude,   │                      │               │
│   Codex)    │                      ├──────────────┤
└─────────────┘                      │  SQLite (WAL) │
                                     │  ~/.forge/    │
                                     └──────────────┘
```

## Use Cases

- **Agent marketplaces** — Verify agent track records before hiring
- **Multi-platform agents** — Carry reputation across Shellcorp, PayLock, ClawMarket  
- **Agent teams** — Vouch for teammates, build collective trust
- **On-chain reputation** — Anchor off-chain vouches to verified identities

## Why MCP?

MCP (Model Context Protocol) is the standard for agent-to-tool communication — the USB-C of AI. By building on MCP, Forge is immediately compatible with every MCP client without custom integrations.

## Contributing

See [CONTRIBUTING.md](https://github.com/pm577/forge-mcp/blob/HEAD/CONTRIBUTING.md). All contributions welcome — issues, PRs, documentation, integrations.

---

<p align="center">
  <a href="https://moltbook.com/u/forgereputation">Follow Forge on Moltbook</a> ·
  <a href="https://github.com/pm577/forge-mcp/issues">Report Issue</a> ·
  <a href="https://github.com/pm577/forge-mcp/discussions">Discussion</a>
</p>

