Skip to content

io.github.ptrinh/freeport-nostr

by ptrinh · remote · local (npm) · no sign-in to list tools · v0.5.0 · published by GitHub user ptrinh

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

Final · 1
CompareRegistry entry

6 tools: 1 do something that can't be undone and 5 only read.

Scanned Oct 21, 2026

No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http freeport-nostr https://nostr-mcp.trinh.uk/mcp

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

6 tools

Can't be undone 1Claude Code: ask
  • freeport_create_postPublish a Freeport intent — an OFFER (side "offer": driver/provider/seller) or a REQUEST (side "request": rider/buyer).No findings

    Why it is in this group

    • The name "freeport_create_post" says "create": a word for a change.
    • The description's first verb is "publish": a word for a change that another call does not undo.
    Description, as the server wrote it
    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`.
Only reads 5Claude Code: allow
  • nostr_get_eventFetch one or more events by id.No findings

    Why it is in this group

    • The name "nostr_get_event" says "get": a word for reading.
    Description, as the server wrote it
    Fetch one or more events by id. Returns the raw signed events.
  • nostr_profileFetch NIP-01 profile metadata (kind 0) for one or more pubkeys — name, about, picture, nip05, lud16, etc.No findings

    Why it is in this group

    • The description's first verb is "fetch": a word for reading.
    Description, as the server wrote it
    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_rawEscape hatch: run an arbitrary NIP-01 filter (kinds/authors/ids/tags/since/until/limit).No findings

    Why it is in this group

    • The name "nostr_query_raw" says "query": a word for reading.
    Description, as the server wrote it
    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.
  • nostr_search_intentsSearch Freeport ride/service/product intents (offers & requests).No findings

    Why it is in this group

    • The name "nostr_search_intents" says "search": a word for reading.
    Description, as the server wrote it
    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_reputationFetch reputation signals for a pubkey: karma ratings (kind 32103) it received and deal receipts (kind 32104).No findings

    Why it is in this group

    • The name "nostr_search_reputation" says "search": a word for reading.
    Description, as the server wrote it
    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.

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 0.5.0. Values in angle brackets are yours to fill in.

claude mcp add --transport http freeport-nostr https://nostr-mcp.trinh.uk/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__freeport-nostr__nostr_search_intents",
      "mcp__freeport-nostr__nostr_search_reputation",
      "mcp__freeport-nostr__nostr_get_event",
      "mcp__freeport-nostr__nostr_profile",
      "mcp__freeport-nostr__nostr_query_raw"
    ],
    "ask": [
      "mcp__freeport-nostr__freeport_create_post"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as freeport-nostr. Review it before you use it.