# Freeport MCP server

> Search and discover decentralized P2P marketplace events on Nostr by kind, tag, and geohash radius.

- Repository: https://github.com/ptrinh/freeport
- Page: https://hostedmcp.org/servers/ptrinh/freeport
- Transport: stdio, remote
- Stars: 16
- License: MIT
- Latest version: 0.5.0

## Install

### Claude Code

```sh
claude mcp add freeport -- npx -y freeport-nostr-mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "freeport": {
      "command": "npx",
      "args": [
        "-y",
        "freeport-nostr-mcp"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "freeport": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "freeport-nostr-mcp"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"freeport","type":"stdio","command":"npx","args":["-y","freeport-nostr-mcp"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "freeport": {
      "command": "npx",
      "args": [
        "-y",
        "freeport-nostr-mcp"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add freeport -- npx -y freeport-nostr-mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.freeport]
command = "npx"
args = ["-y", "freeport-nostr-mcp"]
```

### Gemini CLI

```sh
gemini mcp add -s user freeport npx -- -y freeport-nostr-mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "freeport": {
      "command": "npx",
      "args": [
        "-y",
        "freeport-nostr-mcp"
      ]
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `FREEPORT_RELAYS` | no | no | Comma-separated relay websocket URLs. Defaults to the Freeport public relay set. |

## Tools (5)

- `nostr_search_intents`: Search Freeport ride/service/product intents (offers & requests). Filter by side, category/area topic tags, and an optional geographic radius. Results are decoded, expiry-filtered, and sorted nearest-first when a point is given.
- `nostr_search_reputation`: Fetch reputation signals for a pubkey: karma ratings (kind 32103) it received and deal receipts (kind 32104). Returns proven-deal count (both receipt halves present) and a karma summary. Note: scores are subjective and un-weighted here; do not treat as Sybil-proof.
- `nostr_get_event`: Fetch one or more events by id. Returns the raw signed events.
- `nostr_profile`: Fetch NIP-01 profile metadata (kind 0) for one or more pubkeys — name, about, picture, nip05, lud16, etc. Optionally include each author's most recent notes (kind 1). General-purpose: works for any Nostr user, not just Freeport.
- `nostr_query_raw`: Escape hatch: run an arbitrary NIP-01 filter (kinds/authors/ids/tags/since/until/limit). Use the typed tools above when they fit. Returns raw signed events.

## FAQ

### Is there a central authority or operator?

No, there is no central operator or matching server; all logic is client-side and relays act as simple pub/sub systems.
