Search and discover decentralized P2P marketplace events on Nostr by kind, tag, and geohash radius.
Also known as ptrinh/freeport, freeport, freeport-nostr-mcp
- Stars
- 16
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.5.0
- Last commit
- Sep 24, 2026
- License
- MIT
What is Freeport MCP?
Freeport searches and discover decentralized P2P marketplace events on Nostr by kind, tag, and geohash radius.
Summary generated from the project's README
About Freeport MCP server
Finding decentralized peer-to-peer marketplace events on the Nostr protocol is what this server enables. It allows users to discover trade intents by filtering through specific kinds, tags, or geohash radii. This tool is designed for developers and users interacting with the Freeport ecosystem, a research project focused on pure P2P infrastructure where all logic remains client-side and relays act only as pub/sub mechanisms.
Users can integrate this with their local client setup to navigate topic-scoped markets without a central operator. The server facilitates the discovery of broadcasted intents that can later be settled using Bitcoin Lightning or cash. Because the system relies on decentralized relays rather than a matching server, it provides a way to explore a marketplace where buyers, sellers, riders, and drivers meet through an open protocol.
What you can do with it
- 1Monitor decentralized market feedsIdentify new broadcasted trade intents across different topic-scoped markets.
Written from the project's README. Every use case is checked against a quote from it.
How to install Freeport MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Freeport MCP in Claude Code
$ claude mcp add freeport -- npx -y freeport-nostr-mcpInstall Freeport MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"freeport": {
"command": "npx",
"args": [
"-y",
"freeport-nostr-mcp"
]
}
}
}Install Freeport MCP in VS Code
.vscode/mcp.json
{
"servers": {
"freeport": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"freeport-nostr-mcp"
]
}
}
}Install Freeport MCP in VS Code CLI
$ code --add-mcp '{"name":"freeport","type":"stdio","command":"npx","args":["-y","freeport-nostr-mcp"]}'Install Freeport MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"freeport": {
"command": "npx",
"args": [
"-y",
"freeport-nostr-mcp"
]
}
}
}Install Freeport MCP in Codex
$ codex mcp add freeport -- npx -y freeport-nostr-mcpInstall Freeport MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.freeport] command = "npx" args = ["-y", "freeport-nostr-mcp"]
Install Freeport MCP in Gemini CLI
$ gemini mcp add -s user freeport npx -- -y freeport-nostr-mcpInstall Freeport MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"freeport": {
"command": "npx",
"args": [
"-y",
"freeport-nostr-mcp"
]
}
}
}Configuration
FREEPORT_RELAYSComma-separated relay websocket URLs. Defaults to the Freeport public relay set.
| Name | Description | |
|---|---|---|
| FREEPORT_RELAYS | Comma-separated relay websocket URLs. Defaults to the Freeport public relay set. |
Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packagePass
- Remote endpoint uses HTTPSPass
- Destructive tools are labelledNot checked
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesPass
README
View on GitHubFreeport
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.
- App: https://freeport.network (web/PWA) · iOS · Android · Desktop — Mac/Windows/Linux · Offline HTML
- Whitepaper: PDF
- Self-host:
packages/freeport-self-hosted(docker compose up -d), or any desktop install can host the app for your network withfreeport --serve. - Developers: CONTRIBUTING.md — repo layout, stack decisions, quick start, CLI.
Demo (2 minutes)
https://github.com/user-attachments/assets/506c82ac-c5eb-415d-b981-ba14c4f165bc
Also on the landing page.
Why Freeport exists
- It's a research project. How far can pure P2P infrastructure go? Buyers, sellers, riders, drivers meet over Nostr, settle in Lightning or cash. Nothing in between needs permission to exist.
- It's a thesis. A P2P marketplace with a reputation system works. When people own their reputation, the market self-regulates.
- It's a check and balance. A zero-fee exit that answers to no one puts a ceiling on how greedy the big platforms can get.
- It's fun. An open protocol, Claude Code as a pair programmer, no investor deck.
- Nobody profits — including me. No operator, no cut. A protocol, not a platform. Run it or fork it.
- No one will protect you here — that's the point, and the price. No
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.
What works today
- Everywhere: iOS + Android app stores, web/PWA, desktop installers for
macOS/Windows/Linux with self-update — plus a single-file offline copy:
the whole app in one HTML file that runs from
file://, no install, no server. - Wallet (experimental): built-in self-custodial Bitcoin Lightning +
stablecoin (USDT/USDB) wallet (Breez SDK/Spark).
Keys derive from your Nostr key — one backup covers identity and funds.
Lightning address (
you@freeport.network), on-chain, QR scan, local-currency balances, and one-tap Pay / Pay QR on confirmed deals. Bring your own wallet over NWC instead if you prefer. Spark is a young trust-minimized L2 — treat it as a spending wallet. - Reputation: peer-rated karma, co-signed deal receipts, proven-deal counts, web-of-trust weighting. Sybil resistance stays open — treat zero-history identities with caution.
- Chat: invite-based 1:1 encrypted chat beyond deals — QR/link invites, replies, emoji reactions, disappearing messages, delivery/read receipts, voice messages, location sharing, in-chat search and Lightning payments. Between updated clients it upgrades to NIP-17 gift wrap, so relays can't even see who talks to whom.
- Calls (experimental): peer-to-peer audio/video calls in chat (WebRTC, end-to-end encrypted, signaling over encrypted DMs — no call server), with screen sharing on web. Optional TURN fallback.
- Zaps & Shops: NIP-57 zap tipping on posts (verifiable receipts), and NIP-15 storefronts — durable seller listings with a conversational "chat with seller" checkout.
- Escrow without a custodian: HODL-invoice conditional payments on confirmed deals — the buyer holds the preimage, the seller can only settle on release, unreleased funds auto-refund. The Lightning protocol enforces the lock; nobody ever holds the money in between.
- Mini-apps (experimental): third-party web apps run inside Freeport with
your portable identity (NIP-07) and wallet (WebLN + Spark/stablecoin) —
sandboxed behind a permission firewall where every sensitive action needs
your approval (architecture & threat model).
A dedicated Apps tab hosts the launcher — a home-screen-style grid
(add any app by URL or QR, drag to rearrange), with the wallet as its first
tile; your apps and their grants travel with the account backup. One
<script>tag makes a page work on web too. Mini-app examples:examples/esim-store— eSIM shop with Spark/stablecoin checkout, live at apps.freeport.network/esim-storeexamples/insurance-store— travel insurance quotes underwritten from npub-derived reputation, with a downloadable PDF certificate, live at apps.freeport.network/insurance-storeexamples/id-verification— a paid identity / licence verification service: submit documents, book a video call, and get a shareable verification link for your profile, live at apps.freeport.network/id-verificationexamples/arbitrator— decentralized dispute arbitration: an escrow with the arbitrator as a conditional key, encrypted evidence (NIP-44), and a fee only charged when a dispute is actually raised — the arbitrator's npub karma is their license, live at apps.freeport.network/arbitrator
- On-device AI (experimental): describe what you need in any language and it drafts your post; incoming chat messages auto-translate. Runs entirely on your device (Apple Intelligence / Android ML Kit + Gemini Nano / Chrome built-in AI) — your words never leave it.
- Notifications & Telegram: content-blind push, plus a Telegram bridge — market feeds in groups, one-tap broadcast of organic posts, personal pings.
- 56 languages, full RTL, in-chat translation.
Non-goals (v1)
Custody (payments stay self-custodial wallet-to-wallet; even escrow is trust-minimized HODL invoices, never a held balance), dispute resolution, vetting, anti-sybil — all deliberately deferred.
Donate
BTC: bc1ps44wjx3wpu4s0xj746gz2lu45nspsm9059d3ym8xz0nrhu4psyasdgwwhx
License & forking
MIT (LICENSE). Freeport exists to be forked: any community can stand up its own market — own name, city, vertical, relays and services — by changing configuration, not architecture. FORKING.md lists every deployment-specific value; CONTRIBUTING.md covers dev setup and style.
Freeport MCP questions
How do I add Freeport MCP to Claude Code?
Run claude mcp add freeport -- npx -y freeport-nostr-mcp in your terminal. Add --scope user to make it available in every project.
How do I add Freeport MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
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.