# mcp-server-moltmark

A Model Context Protocol (MCP) server for Moltmark agent certification. This server provides tools for managing agent trust scores, capabilities, and certification status.

## Features

- **Agent Certification** - Track and verify agent trust scores
- **Capability Registry** - Declare and manage agent skills
- **Test Results** - Record test outcomes that affect trust scores
- **Auto-Certification** - Agents are automatically certified when they reach 80% trust score with 5+ tests

## Installation

```bash
npm install mcp-server-moltmark
```

Or run directly with npx:

```bash
npx mcp-server-moltmark
```

## Requirements

- Node.js 18+
- PostgreSQL database
- `DATABASE_URL` environment variable

## Configuration

Set the `DATABASE_URL` environment variable to your PostgreSQL connection string:

```bash
export DATABASE_URL="postgresql://user:password@localhost:5432/moltmark"
```

### Claude Desktop Configuration

Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "moltmark": {
      "command": "npx",
      "args": ["mcp-server-moltmark"],
      "env": {
        "DATABASE_URL": "postgresql://user:password@localhost:5432/moltmark"
      }
    }
  }
}
```

## Tools

### get_certification

Query the certification status of an agent, including trust score, capabilities, and test history.

```typescript
get_certification({ agent_id: "agent-123" })
```

Returns:
- Agent details (trust score, certified status)
- List of declared capabilities
- Recent test results
- Test summary (passed/failed counts)

### report_test_result

Submit a test outcome for an agent's capability. This affects the agent's trust score.

```typescript
report_test_result({
  agent_id: "agent-123",
  capability: "code-generation",
  result: "pass", // or "fail"
  evidence: "Successfully generated valid TypeScript code for the given task"
})
```

The trust score is automatically recalculated after each test result.

### declare_capability

Register a new skill or capability for an agent.

```typescript
declare_capability({
  agent_id: "agent-123",
  capability_name: "code-generation",
  description: "Ability to generate code in multiple programming languages"
})
```

### verify_agent

Check if an agent meets a minimum trust score threshold.

```typescript
verify_agent({
  agent_id: "agent-123",
  min_trust_score: 75
})
```

Returns whether the agent meets the threshold and the reason.

### list_verified_agents

Get a list of certified agents, optionally filtered by capability.

```typescript
// List all certified agents
list_verified_agents({})

// Filter by capability
list_verified_agents({ capability_filter: "code" })
```

## Trust Score Calculation

- Trust score = (passed tests / total tests) × 100
- Auto-certification occurs when:
  - Trust score ≥ 80%
  - At least 5 tests recorded

## Database Schema

The server automatically creates the following tables:

- `agents` - Stores agent information and certification status
- `capabilities` - Stores declared capabilities per agent
- `test_results` - Records all test outcomes

## Development

```bash
# Clone the repository
git clone https://github.com/yourusername/mcp-server-moltmark.git
cd mcp-server-moltmark

# Install dependencies
npm install

# Build
npm run build

# Run locally
DATABASE_URL="postgresql://..." npm start
```

## License

MIT