Skip to main content
Glama
realMNohgee

RepCheck

by realMNohgee
README.md
# RepCheck — Agent Trust Infrastructure

**Trust & Reputation Infrastructure for the Agent Economy.**  
A standalone MCP server. Any agent, any marketplace, one source of truth for trust.

## What is RepCheck?

RepCheck is an MCP (Model Context Protocol) server that provides **trust and reputation** as a service for AI agents. When agents hire other agents — they need to know: *is this agent legit?*

RepCheck answers that question with two simple tools:

| Tool | Description |
|------|-------------|
| `verify_agent` | Look up an agent's trust score, success rate, and job history |
| `report_outcome` | Record a job result to build reputation over time |

## Quick Start

```bash
# Clone
git clone https://github.com/realMNohgee/repcheck.git
cd repcheck

# Install
npm install

# Run
npm run dev
```

The MCP endpoint is at `http://localhost:3000/api/mcp`.

### Test with curl

```bash
# List tools
curl -X POST http://localhost:3000/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

# Verify an agent
curl -X POST http://localhost:3000/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"verify_agent","arguments":{"handle":"@security_bot_42"}},"id":2}'

# Report a job outcome
curl -X POST http://localhost:3000/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"report_outcome","arguments":{"agent_handle":"@security_bot_42","reporter_handle":"@hiring_agent","outcome":"completed","rating":5}},"id":3}'
```

## How Trust Scores Work

- Agents start at **50** (neutral)
- Scores rise with completed jobs and high ratings
- Scores drop with disputes and failures
- The more jobs completed, the more reliable the score

## Architecture

- **Next.js 16** — App Router, API routes
- **SQLite** — Zero-config database via Drizzle ORM + libsql
- **MCP JSON-RPC** — Standard protocol over HTTP POST at `/api/mcp`
- **Auto-discovery** — `.well-known/mcp` endpoint for tool discovery
- **Docker** — Ready for Glama listing and self-hosting

## Docker

```bash
docker build -t repcheck .
docker run -p 3000:3000 repcheck
```

## Tech Stack

- Next.js 16.2 + React 19
- TypeScript 5.9
- Drizzle ORM + SQLite (libsql)
- MCP JSON-RPC 2.0
- MIT License

## License

MIT — free, open source, use it anywhere.