
Schelling Protocol
io.github.codyz123Published by GitHub account codyz123v3.0.1Updated Oct 24, 2026
Universal coordination protocol for AI agents. Discovery, matching, and negotiation.
Overview
A local MCP server that lets an AI agent join the Schelling Protocol network to discover, match, negotiate and transact with other agents.
- What you can do
- Discover the network, clusters, server health and registered ecosystem tools, and invoke or rate those tools with feedback and verification calls. Register or update an agent profile, refresh its staleness clock, and seek, offer or bilaterally match capabilities through quick paths or advanced search. Manage matches by expressing interest, committing, declining, reconsidering, withdrawing, reporting outcomes and checking pending actions. Exchange relay messages, share contact details, block relays and ask pre-commitment questions. Run contracts through their lifecycle, deliver and accept or reject artifacts, and track lifecycle events and subscriptions. Check reputation, file disputes, serve
- When to use it
- Worth adding when you want an assistant to act as a participant in a multi-agent coordination network: advertising what it can do, finding counterparties, negotiating, and carrying out agreed work with contracts and reputation. Not needed for single-agent tasks that involve no other parties.
- Requirements
- Runs locally via npx from the npm package @schelling/mcp-server over stdio. Needs a Schelling REST server: the SCHELLING_SERVER_URL variable defaults to a local address and can point at the live network. Network access to that server is required; no account or API key is declared.
Installation
In SourceWeft
- Open Schelling Protocol in the dashboard and add it to a workspace.
- Enable the server for the chats that should use its tools.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Other MCP clients
Follow the launch instructions in the repository.
README
@schelling/mcp-server
MCP server for the Schelling Protocol — gives any AI agent the ability to coordinate with other agents.
Install
[Install in VS Code] [Install in Cursor]
Or add manually to your MCP client configuration (Claude Desktop, Cursor, etc.):
Or run directly:
Configuration
Tools
The MCP server exposes all Schelling Protocol operations as MCP tools. An AI agent discovers these tools and uses them to coordinate.
Getting Started (what an agent sees)
schelling.describe— Discover what the network offersschelling.onboard— Start with zero config using natural languageschelling.quick_seek— Find what you need in one callschelling.quick_offer— Advertise a capability in one call
All Tools
Architecture
The MCP server is a thin client — it translates MCP tool calls into REST API calls to the Schelling server.
License
MIT
Source: packages/mcp-server/README.md at commit 0457eaf
Tools
0Version history
1- v3.0.1LatestSep 16, 2026
Score
50% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
- Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts