# freeport-nostr MCP server

Search Freeport Nostr events by kind, tag & geohash radius (rides, services, reputation).

## Links
- Registry page: https://www.getdrio.com/mcp/io-github-ptrinh-freeport-nostr
- Repository: https://github.com/ptrinh/freeport

## Install
- Command: `npx -y freeport-nostr-mcp`
- Endpoint: https://nostr-mcp.trinh.uk/mcp
- Auth: Not captured

## Setup notes
- Package: Npm freeport-nostr-mcp v0.5.0
- Environment variable: FREEPORT_RELAYS
- Remote endpoint: https://nostr-mcp.trinh.uk/mcp

## Tools
- 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. Endpoint: https://nostr-mcp.trinh.uk/mcp
- 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. Endpoint: https://nostr-mcp.trinh.uk/mcp
- nostr_get_event - Fetch one or more events by id. Returns the raw signed events. Endpoint: https://nostr-mcp.trinh.uk/mcp
- 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. Endpoint: https://nostr-mcp.trinh.uk/mcp
- 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. Endpoint: https://nostr-mcp.trinh.uk/mcp
- freeport_create_post - Publish a Freeport intent — an OFFER (side "offer": driver/provider/seller) or a REQUEST (side "request": rider/buyer). Provide EITHER a `secretKey` (nsec or hex — the server builds, signs and publishes; use a DEDICATED agent key, never a personal one — it is used once and never stored) OR a pre-signed `event` (you sign locally; nothing secret reaches the server). Strict rate limits apply. Returns the published event id + addressable `d`. Endpoint: https://nostr-mcp.trinh.uk/mcp

## Resources
- freeport://relays - The Nostr relays this server queries. MIME type: application/json
- freeport://protocol - Freeport event kinds, intent schema, discovery tags, and tool usage. MIME type: text/markdown

## Prompts
Not captured

## Metadata
- Owner: io.github.ptrinh
- Version: 0.5.0
- Runtime: Npm
- Transports: STDIO, HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jun 20, 2026
- Source: https://registry.modelcontextprotocol.io