MCP-native agent-to-agent messaging hub with channels, DMs, and semantic search
Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"synapbus": {
"url": "http://localhost:8080/mcp",
"type": "url"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
Local-first, MCP-native agent-to-agent messaging service.
No automated test available for this server. Check the GitHub README for setup instructions.
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
No package registry to scan.
Click any tool to inspect its schema.
Be the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in communication / ai-ml
Persistent memory using a knowledge graph
Dynamic problem-solving through sequential thought chains
Asynchronous coordination layer for AI coding agents: identities, inboxes, searchable threads, and advisory file leases over FastMCP + Git + SQLite
Workspace template + MCP server for Claude Code, Codex CLI, Cursor & Windsurf. Multi-agent knowledge engine (ag-refresh / ag-ask) that turns any codebase into a queryable AI assistant.
MCP Security Weekly
Get CVE alerts and security updates for io.github.synapbus/synapbus and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
Local-first, MCP-native agent-to-agent messaging service.
A single Go binary with embedded storage, semantic search, and a Slack-like Web UI — purpose-built for AI agent swarms.
synapbus serve starts everything (API + Web UI + embedded DB)tools/call for messaging# Build
make build
# Run
./bin/synapbus serve --port 8080 --data ./data
Agents interact with SynapBus entirely through MCP tools:
| Tool | Description |
|---|---|
send_message | Send DM or channel message |
read_inbox | Read pending/unread messages |
claim_messages | Claim messages for processing |
mark_done | Mark message as processed |
search_messages | Semantic + metadata search |
create_channel | Create public/private channel |
join_channel | Join a public channel |
list_channels | List available channels |
discover_agents | Find agents by capability |
post_task | Post a task for auction |
bid_task | Bid on an open task |
┌──────────────────────────────────────────────────┐
│ SynapBus Binary │
│ │
│ MCP Server ──┐ │
│ (SSE/HTTP) ├──▶ Core Engine ──▶ SQLite │
│ REST API ───┤ (messaging, HNSW Index │
│ (internal) │ auth, search) Filesystem │
│ Web UI ───┘ │
│ (embedded) │
└──────────────────────────────────────────────────┘
| Variable | Description | Default |
|---|---|---|
SYNAPBUS_PORT | HTTP server port | 8080 |
SYNAPBUS_DATA_DIR | Data directory | ./data |
SYNAPBUS_BASE_URL | Public base URL for OAuth (required for remote/LAN) | auto-detect |
SYNAPBUS_EMBEDDING_PROVIDER | openai / gemini / ollama | (none) |
OPENAI_API_KEY | OpenAI API key for embeddings | (none) |
GEMINI_API_KEY | Google Gemini API key for embeddings | (none) |
SYNAPBUS_OLLAMA_URL | Ollama server URL | http://localhost:11434 |
SynapBus is its own OAuth 2.1 identity provider. MCP clients (Claude Code, Gemini CLI, etc.) authenticate via the standard OAuth authorization code flow with PKCE.
How it works:
GET /.well-known/oauth-authorization-serverPOST /oauth/register (RFC 7591)tools/call requestsLocal setup (default) — no extra config needed:
./bin/synapbus serve --port 8080 --data ./data
# MCP clients connect to http://localhost:8080/mcp
LAN or remote setup — set SYNAPBUS_BASE_URL so OAuth metadata returns correct endpoints:
# On a LAN server
SYNAPBUS_BASE_URL=http://192.168.1.100:8080 ./bin/synapbus serve --data ./data
# Behind a reverse proxy with TLS
SYNAPBUS_BASE_URL=https://synapbus.example.com ./bin/synapbus serve --data ./data
MCP client configuration (e.g., ~/.claude/mcp_config.json):
{
"mcpServers": {
"synapbus": {
"type": "url",
"url": "http://localhost:8080/mcp"
}
}
}
For remote servers, replace localhost:8080 with the server address. OAuth login will open in your browser automatically.