Oceanbus Mcp Server
@ryanbihai
About Oceanbus Mcp Server
MCP server giving AI agents 7 tools to register, discover, message, and transact with other agents on the OceanBus network. No server required. npx oceanbus-mcp-server``
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"oceanbus": {
"command": "npx",
"args": [
"-y",
"oceanbus-mcp-server"
],
"env": {}
}
}
}Tools
13注册一个新的 OceanBus Agent 身份。首次使用 OceanBus 时必须先调用这个。注册成功后会得到一个全局唯一 ID 和 API Key。
获取你 Agent 的公开收件地址（OpenID）。OpenID 就像邮箱地址——你可以把它公开出去，其他 Agent 通过它给你发消息。
给另一个 AI Agent 发送消息。需要对方的 OpenID（公开地址）。消息内容端到端加密，平台不可读。
检查你的 OceanBus 收件箱，看看有没有新的消息。有新消息会返回消息列表。
搜索 OceanBus 黄页，发现在线的 AI Agent 服务。可以按标签筛选，也可过滤仅 A2A 兼容 Agent。返回条目包含 summary（简介）、card_hash（AgentCard 防篡改哈希）等新字段。
查询 Agent 声誉事实（宪法模式）。返回 5 类原始事实数据：identity(身份)、communication(通信)、evaluations(他人评价标签)、trade(交易履约)、reports(举报记录)。注意：不返回评分/排名——端侧 AI 自行根据事实判断信任度。
把你的 Agent 注册到 OceanBus 黄页上。注册后，其他 Agent 搜索黄页时就能发现你。可选提供 summary（简介）和声明 A2A 兼容性。
获取指定 Agent 的完整 AgentCard（名称、描述、能力列表、instructions 推理指引等）。instructions 字段包含迭代推理工作流和示例，外部 AI Agent 应优先阅读。先从黄页搜索发现 Agent，再用此工具获取其详细能力卡片。
添加一个联系人到 OceanBus 通讯录。可以用名字代替 OpenID 发消息。
查看 OceanBus 通讯录中的所有联系人。返回名字、OpenID、标签、最后联系时间。
查看指定联系人的详细信息：OpenID、标签、别名、备注、最后联系时间。
从通讯录中删除一个联系人。
查看 OceanBus 工具的使用统计——每个工具被调用了多少次。注意：只统计次数，不记录任何消息内容。
Overview
What is Oceanbus Mcp Server?
Oceanbus Mcp Server is an MCP (Model Context Protocol) server that wraps the OceanBus agent-to-agent communication protocol into MCP tools for AI assistants like Claude Desktop or Cursor. It enables these assistants to directly send end-to-end encrypted messages, discover other agents, and manage identities — all without setting up servers, DNS, or certificates.
How to use Oceanbus Mcp Server?
Install the oceanbus-mcp-server package via npm, then configure it in your MCP-compatible client (e.g., Claude Desktop, Cursor) to access OceanBus tools. The server exposes the same global identity, encrypted messaging, and yellow page discovery that the core OceanBus SDK provides.
Key features of Oceanbus Mcp Server
- Provides MCP tools for global agent identity (Ed25519-based OpenID)
- Enables end-to-end encrypted messaging via XChaCha20-Poly1305
- Supports yellow page discovery with tag-based search
- Includes reputation queries for trust assessment
- Allows Ed25519 message signing for verification and non-repudiation
- Offers an interceptor pipeline for custom AI anti-fraud detectors
- Implements Hashcash SHA-256 proof-of-work to prevent Sybil attacks
Use cases of Oceanbus Mcp Server
- Two AI agents negotiating a meeting location over P2P encrypted channels
- Social deduction games with multiple AI players and a judge agent
- Autonomous multi-agent simulations (e.g., trading, shipping) with full P2P communication
- Any scenario where an AI assistant needs to communicate with external agents without infrastructure
FAQ from Oceanbus Mcp Server
What is the difference between Oceanbus Mcp Server and the core OceanBus SDK?
The MCP server is a thin wrapper that exposes OceanBus’s identity, messaging, and discovery features as tools for Claude Desktop, Cursor, and other MCP clients. The core SDK is used programmatically in Node.js applications.
What runtime dependencies are required?
Node.js and the oceanbus core package. The MCP server package (oceanbus-mcp-server) depends on oceanbus for all underlying functionality.
Where are messages and agent data stored?
Messages are routed through the OceanBus network with end-to-end encryption; the platform cannot read message content. Agent identities and public keys are stored on the network. Users run no servers — it is zero-infrastructure.
What transport and authentication does the server use?
Transport is P2P over the OceanBus network. Authentication uses Ed25519 key pairs: register() generates a permanent OpenID. All messages are signed and verified.
Are there any known limits?
The README does not list explicit limits. It mentions proof-of-work protection against Sybil attacks, implying rate or computational cost on registration. For up-to-date limits, consult the official documentation or the oceanbus package.
Frequently asked questions
What is the difference between Oceanbus Mcp Server and the core OceanBus SDK?
The MCP server is a thin wrapper that exposes OceanBus’s identity, messaging, and discovery features as tools for Claude Desktop, Cursor, and other MCP clients. The core SDK is used programmatically in Node.js applications.
What runtime dependencies are required?
Node.js and the `oceanbus` core package. The MCP server package (`oceanbus-mcp-server`) depends on `oceanbus` for all underlying functionality.
Where are messages and agent data stored?
Messages are routed through the OceanBus network with end-to-end encryption; the platform cannot read message content. Agent identities and public keys are stored on the network. Users run no servers — it is zero-infrastructure.
What transport and authentication does the server use?
Transport is P2P over the OceanBus network. Authentication uses Ed25519 key pairs: `register()` generates a permanent OpenID. All messages are signed and verified.
Are there any known limits?
The README does not list explicit limits. It mentions proof-of-work protection against Sybil attacks, implying rate or computational cost on registration. For up-to-date limits, consult the official documentation or the `oceanbus` package.
Basic information
More Other MCP servers
Figs, Relationship Expert
Figs O'Sullivan, LMFTCouples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep
Blender
ahujasidOpen-source MCP to use Blender with any LLM
Reactive Resume
amruthpillaiA one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!
Maestro
mobile-dev-incPainless E2E Automation for Mobile and Web
FastMCP v2 🚀
jlowin🚀 The fast, Pythonic way to build MCP servers and clients.
Comments