freeport-nostr — Claude Code MCP server: search and setup
Search Nostr events by kind, tags, and geohash radius. Use it to find rides, services, and reputation-related records through an agent.
claude mcp add --transport http freeport-nostr https://nostr-mcp.trinh.uk/mcpWhat freeport-nostr does
freeport-nostr gives an agent a way to search Nostr events. Queries can narrow results by event kind, tag, or distance around a geohash, with rides, services, and reputation listed as target data.
Claude Code can connect over HTTP to the hosted MCP endpoint or start the server locally with npx -y freeport-nostr-mcp. The stdio setup passes relay addresses through FREEPORT_RELAYS, so that value has to be prepared first. The server is also listed for Codex, Cursor, GitHub Copilot, and the other supported platforms.
What it helps with
- search Nostr events by kind
- filter records with a tag
- find rides within a geohash radius
- locate reputation-related events
Example prompts for the agent
- Search Nostr for rides near this geohash and filter the results by the requested tag.
- Find service events of this kind within the given radius.
- Look up reputation-related events and group the results by kind.
How to install freeport-nostr
1Platform CLI: remote server
claude mcp add --transport http freeport-nostr https://nostr-mcp.trinh.uk/mcp2Platform CLI
claude mcp add --env FREEPORT_RELAYS=<FREEPORT_RELAYS> --transport stdio freeport-nostr -- npx -y freeport-nostr-mcpReplace <…> with your own values
1Platform CLI: remote server
codex mcp add freeport-nostr --url https://nostr-mcp.trinh.uk/mcp2Platform CLI
codex mcp add freeport-nostr --env FREEPORT_RELAYS=<FREEPORT_RELAYS> -- npx -y freeport-nostr-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"freeport-nostr": {
"url": "https://nostr-mcp.trinh.uk/mcp"
}
}
}{
"mcpServers": {
"freeport-nostr": {
"command": "npx",
"args": [
"-y",
"freeport-nostr-mcp"
],
"env": {
"FREEPORT_RELAYS": "<FREEPORT_RELAYS>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"freeport-nostr": {
"type": "http",
"url": "https://nostr-mcp.trinh.uk/mcp"
}
}
}{
"servers": {
"freeport-nostr": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"freeport-nostr-mcp"
],
"env": {
"FREEPORT_RELAYS": "<FREEPORT_RELAYS>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http freeport-nostr https://nostr-mcp.trinh.uk/mcp2Platform CLI
gemini mcp add -e FREEPORT_RELAYS=<FREEPORT_RELAYS> freeport-nostr npx -y freeport-nostr-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about freeport-nostr
How do I install freeport-nostr in Claude Code?
Run claude mcp add --transport http freeport-nostr https://nostr-mcp.trinh.uk/mcp.
What does freeport-nostr do?
It is an MCP server for finding Nostr events by kind, tags, and geohash radius. An agent can use it to search records about rides, services, and reputation.
What is required for a local stdio setup?
Start npx -y freeport-nostr-mcp and provide relay addresses through the FREEPORT_RELAYS environment variable.
