Freeport Nostr MCP server
Search Freeport Nostr events by kind, tag & geohash radius (rides, services, reputation).
16 stars35 downloads/wk
Reviews
Write oneNobody has reviewed Freeport Nostr yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Freeport Nostr tools (6, 1 write)
write = sends, deletes, buys or postsfreeport_create_postwrite actionFreePublish 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`.
nostr_get_eventFreeFetch one or more events by id. Returns the raw signed events.
nostr_profileFreeFetch 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_rawFreeEscape 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_intentsFreeSearch 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_reputationFreeFetch 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.
Public scan report
scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it
- Code scan3 source files scanned25/25
- Live reliabilityremote reachable in 3189ms17/20
- Tool poisoning6 tool descriptions checked15/15
- Auth qualityopen endpoint exposes 1 write-action tools with no auth3/15
- Maintenancelast push 3 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Findings (1)
- highWrite-action tools reachable without authentication
auth.open-write
What the publisher says
From the Freeport Nostr repository's README, as published. We do not edit it. Read it on GitHub
Freeport
Decentralized P2P marketplace over Nostr. Users broadcast trade intents into topic-scoped markets; personal agents discover counterpart intents and negotiate automatically. Humans confirm final deals. No central operator, no matching server — relays are dumb pub/sub, all logic is client-side.
(docker compose up -d), or any desktop install can host the app for your network with freeport --serve.
- App: https://freeport.network (web/PWA) · iOS · Android · Desktop — Mac/Windows/Linux · Offline HTML
- Whitepaper: PDF
- Self-host: packages/freeport-self-hosted
decisions, quick start, CLI.
- Developers: CONTRIBUTING.md — repo layout, stack
Demo (2 minutes)
https://github.com/user-attachments/assets/506c82ac-c5eb-415d-b981-ba14c4f165bc
Also on the landing page.
Why Freeport exists
sellers, riders, drivers meet over Nostr, settle in Lightning or cash. Nothing in between needs permission to exist.
- It's a research project. How far can pure P2P infrastructure go? Buyers,
people own their reputation, the market self-regulates.
- It's a thesis. A P2P marketplace with a reputation system works. When
ceiling on how greedy the big platforms can get.
- It's a check and balance. A zero-fee exit that answers to no one puts a
investor deck.
- It's fun. An open protocol, Claude Code as a pair programmer, no
platform. Run it or fork it.
- Nobody profits — including me. No operator, no cut. A protocol, not a
support line, no refunds, no central authority. Your judgment comes first, backed by opt-in safeguards no operator runs: a reputation system (karma, co-signed receipts, web-of-trust), escrow arbitration (examples/arbitrator), ID verification (examples/id-verification), and insurance (examples/insurance-store) priced from reputation. You choose how much of the safety net to use.
- No one will protect you here — that's the point, and the price. No
What works today
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Install directly
claude mcp add --transport http freeport-nostr https://nostr-mcp.trinh.uk/mcp
Freeport Nostr: common questions
- Is Freeport Nostr MCP server safe?
- Mostly: it is graded B (83/100). Read the Freeport Nostr safety report
- How do I install Freeport Nostr?
- It runs remotely at nostr-mcp.trinh.uk. Add it to Claude Code, Claude Desktop or Cursor with the snippets above, or call it through the mcp.market gateway without installing anything.
- Does Freeport Nostr need an API key?
- No secret keys are declared. It reads 1 setting from the environment.
- Is Freeport Nostr maintained?
- The last commit was 3 days ago (2026-09-24). The latest release is v0.5.0.
- Is Freeport Nostr up?
- 100% of our last 28 checks got an answer. We check remote servers about four times a day.
- What can I use instead of Freeport Nostr?
- Servers from other publishers that do the same job: OpenAgenda MCP server and Stackexchange MCP server.
Alternatives to Freeport Nostr
Same job from other publishers: the closest match first, then the best rated.
OpenAgendaSearch, analyze and manage events on OpenAgenda.not reviewedGrowingA- StackexchangeSearch Stack Exchange questions, fetch Q&A threads as markdown, look up tag FAQs and user profiles.not reviewedGrowingA
