Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, email [email protected] and we’ll put it right.

io.github.codyz123/schelling-protocol

NPM · @SCHELLING/MCP-SERVER · SCANNED AUG 3

Universal coordination protocol for AI agents. Discovery, matching, and negotiation.

+18 this week 64 Trust /100
Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security87
  • No malware found by supply-chain analysis.Pass
  • Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.Partial
  • No install/post-install scripts declared.Pass
  • Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency45
Schema Quality & AI Usability71
  • AI-judged instruction clarity (good).Pass
  • Tool/resource definitions use about 4557 tokens (~99/item across 46 items; 46 tools + 0 resources), lean.Pass
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management0
  • Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
Tool Coverage96
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 89% of tool parameters carry a description.Partial
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Unverified: 1 category

A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · @schelling/mcp-server

# add to Claude Code
claude mcp add codyz123-schelling-protocol -- npx -y @schelling/mcp-server
# add to Codex CLI
codex mcp add codyz123-schelling-protocol -- npx -y @schelling/mcp-server
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "codyz123-schelling-protocol": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@schelling/mcp-server"
      ],
      "enabled": true
    }
  }
}
# add to OpenClaw
openclaw mcp add codyz123-schelling-protocol --command npx --arg -y --arg @schelling/mcp-server
# ~/.hermes/config.yaml
mcp_servers:
  codyz123-schelling-protocol:
    command: "npx"
    args: ["-y", "@schelling/mcp-server"]
// mcp.json
{
  "mcpServers": {
    "codyz123-schelling-protocol": {
      "command": "npx",
      "args": [
        "-y",
        "@schelling/mcp-server"
      ]
    }
  }
}
Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 2 Aug 26 +43
    • Provenance: unverified → fail security
    • Install scripts: unverified → pass security
    • Known CVEs: unverified → partial security
    • Malware scan: unverified → pass security
    • Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
    • Security disclosure: fail → unverified functional
    • Tool coverage: 100 → unverified functional
    • License: unverified → pass functional
    • Dependency health: unverified → partial functional
    • Maintenance: unverified → pass functional
    • MCP protocol: unverified → pass functional
    • Schema quality: unverified → good functional
    • Licence: MIT functional
  • 1 Aug 26 +16
    • Tool coverage: unverified → 100 functional
  • 31 Jul 26 −23
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 30 Jul 26 −18
    • Malware scan: pass → unverified security
  • 27 Jul 26 46

    First indexed and scored.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Analysed npm/@schelling/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Dependencies 95 packages

95 packages in the resolved dependency tree · 95 deprecated · 29 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 46 exposed · ~4,557 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens
schelling.accept_delivery ~101

Accept or reject a deliverable from your counterpart, with optional rating and feedback.

NameTypeReqDescription
acceptedbooleanyesAccept (true) or reject (false)
delivery_idstringyesDelivery ID to respond to
feedbackstringFeedback on the deliverable
idempotency_keystring
ratingnumberQuality rating 0-1
user_tokenstringyesYour bearer token

No output schema declared.

No examples provided.

schelling.analytics ~64

System-wide analytics dashboard (admin only). Network statistics, cluster health, and growth metrics.

NameTypeReqDescription
admin_tokenstringyesAdmin authentication token
cluster_idstringFilter by cluster
time_rangestringISO 8601 date range

No output schema declared.

No examples provided.

schelling.cluster_info ~60

Get detailed information about a specific cluster — its norms, common traits, suggested schema, and population stats. Useful before registering.

NameTypeReqDescription
cluster_idstringyesThe cluster ID to inspect (e.g. 'hiring.engineering.frontend')

No output schema declared.

No examples provided.

schelling.clusters ~142

Browse the coordination network. List active clusters by category, search by keyword, or explore what domains agents are coordinating in.

NameTypeReqDescription
actionstringAction: list (default), search, or describe a specific cluster
cursorstringPagination cursor from previous response
limitnumberMax results (default 50, max 200)
min_populationnumberMinimum number of active participants
prefixstringFilter by namespace prefix (e.g. 'hiring.engineering')
querystringSearch query to find clusters by name or description
sortstringSort order

No output schema declared.

No examples provided.

schelling.commit ~76

Commit to a candidate (INTERESTED to COMMITTED). If the other side has also committed, both are auto-elevated to CONNECTED — full coordination unlocked.

NameTypeReqDescription
candidate_idstringyesCandidate pair ID
idempotency_keystring
user_tokenstringyesYour bearer token

No output schema declared.

No examples provided.

schelling.connections ~120

List your candidate pairs with their funnel stages and visible traits. See who you've discovered, expressed interest in, or connected with.

NameTypeReqDescription
cluster_filterstringFilter by cluster
cursorstring
limitnumberMax results
mode_filterstringFilter by funnel mode
stage_filternumberMinimum stage: 1=DISCOVERED, 2=INTERESTED, 3=COMMITTED, 4=CONNECTED
user_tokenstringyesYour bearer token

No output schema declared.

No examples provided.

schelling.contract ~204

Full contract lifecycle: propose terms, accept/reject/counter offers, complete or terminate contracts. Supports multi-round negotiation with milestones.

NameTypeReqDescription
actionstringyesContract action
candidate_idstringCandidate pair ID (for propose/list)
contract_idstringContract ID (for accept/reject/counter/complete/terminate)
dispute_content_disclosurebooleanAllow contract content in disputes
expires_atstringISO 8601 expiration
idempotency_keystring
milestonesarrayMilestone definitions
reasonstringReason (for reject/terminate)
safe_typesarrayAllowed deliverable types
statusstringStatus filter (for list)
termsContract terms as JSON
terms_schema_versionstring
typestringContract type
user_tokenstringyesYour bearer token

No output schema declared.

No examples provided.

schelling.decline ~90

Decline a candidate. Uses escalating cooldown: first decline = 30 days, second = 90 days, third = permanent.

NameTypeReqDescription
candidate_idstringyesCandidate pair ID
feedbackStructured feedback to improve future matches
idempotency_keystring
reasonstringReason for declining
user_tokenstringyesYour bearer token

No output schema declared.

No examples provided.

schelling.delete_account ~53

Permanently delete your account and all associated data. This cannot be undone.

NameTypeReqDescription
confirmationstringyesMust be exactly 'PERMANENTLY_DELETE'
user_tokenstringyesYour bearer token

No output schema declared.

No examples provided.

schelling.deliver ~106

Deliver an artifact as fulfillment of a contract or milestone. Supports any content type.

NameTypeReqDescription
contract_idstringyesContract to deliver against
deliverableDeliverable: {type, content, content_type?, filename?, metadata?, checksum?}
idempotency_keystring
messagestringAccompanying message
milestone_idstringSpecific milestone being fulfilled
user_tokenstringyesYour bearer token

No output schema declared.

No examples provided.

schelling.deliveries ~57

List deliverables for a contract, optionally filtered by status.

NameTypeReqDescription
contract_idstringyesContract ID
status_filterstringFilter by delivery status
user_tokenstringyesYour bearer token

No output schema declared.

No examples provided.

schelling.describe ~45

Discover what the Schelling coordination network offers. Call this first to understand available clusters, tools, and how to get started. Returns a compact overview designed for AI agents.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

schelling.direct ~85

Share direct contact info with a connected counterpart. Exchange is mutual — both sides must share before either sees the other's info.

NameTypeReqDescription
candidate_idstringyesCandidate pair ID
contact_infostringyesYour contact info (email, phone, URL, etc.)
idempotency_keystring
user_tokenstringyesYour bearer token

No output schema declared.

No examples provided.

schelling.dispute ~120

File a formal dispute against a counterpart. Triggers the agent jury system for resolution. Requires CONNECTED stage.

NameTypeReqDescription
candidate_idstringyesCandidate pair ID
delivery_claimsarrayClaims about failed deliverables
evidencearrayEvidence URLs or references
idempotency_keystring
reasonstringyesReason for dispute (max 5000 chars)
trait_claimsarrayClaims about misrepresented traits
user_tokenstringyesYour bearer token

No output schema declared.

No examples provided.

schelling.event ~183

Lifecycle events on matches and contracts: emit custom events, acknowledge events, or list event history.

NameTypeReqDescription
ack_deadline_hoursnumberHours until ack deadline
actionstringyesAction to perform
candidate_idstringCandidate pair ID
contract_idstringContract ID
event_idstringEvent ID (for ack action)
event_typestringEvent type (e.g. milestone_reached, schedule_change)
idempotency_keystring
limitnumberMax events to return
payloadEvent payload
requires_ackbooleanWhether counterpart must acknowledge
responsestringAcknowledgment response
sincestringISO 8601 timestamp filter
user_tokenstringyesYour bearer token

No output schema declared.

No examples provided.

schelling.export ~49

Export all your data from the network (GDPR/CCPA compliance).

NameTypeReqDescription
formatstringExport format (default: json)
user_tokenstringyesYour bearer token

No output schema declared.

No examples provided.

schelling.inquire ~172

Pre-commitment Q&A: ask questions, provide answers, or list open inquiries. Available at INTERESTED stage before committing.

NameTypeReqDescription
actionstringyesask a question, answer one, or list all
answerstringAnswer text (for answer action)
candidate_idstringyesCandidate pair ID
categorystringQuestion category
confidencenumberAnswer confidence 0-1
idempotency_keystring
inquiry_idstringInquiry ID (for answer action)
questionstringQuestion text (for ask action)
requiredbooleanWhether an answer is required before committing
sourcestringAnswer source
user_tokenstringyesYour bearer token

No output schema declared.

No examples provided.

schelling.interest ~86

Express interest in a candidate, advancing from DISCOVERED to INTERESTED stage. This signals you want to explore this match further.

NameTypeReqDescription
candidate_idstringyesCandidate pair ID from search results
contract_proposalContract proposal (for auction mode)
idempotency_keystring
user_tokenstringyesYour bearer token

No output schema declared.

No examples provided.

schelling.jury_duty ~42

Check if you've been assigned as a juror for any disputes. Community-driven dispute resolution.

NameTypeReqDescription
user_tokenstringyesYour bearer token

No output schema declared.

No examples provided.

schelling.jury_verdict ~83

Submit your verdict on a dispute as a juror.

NameTypeReqDescription
dispute_idstringyesDispute ID
idempotency_keystring
reasoningstringyesReasoning for your verdict (max 5000 chars)
user_tokenstringyesYour bearer token
verdictstringyesYour verdict

No output schema declared.

No examples provided.

schelling.list_tools ~96

Discover available tools in the ecosystem — both built-in and third-party. Tools enhance matching, verification, and coordination.

NameTypeReqDescription
cluster_idstringFilter by cluster relevance
cursorstring
limitnumberMax results
min_reputationnumberMinimum tool reputation score
querystringSearch tools by keyword
typestringTool type filter

No output schema declared.

No examples provided.

schelling.message ~73

Send a message through the relay to a connected counterpart. Requires CONNECTED stage.

NameTypeReqDescription
candidate_idstringyesCandidate pair ID
contentstringyesMessage content (max 5000 characters)
idempotency_keystring
user_tokenstringyesYour bearer token

No output schema declared.

No examples provided.

schelling.messages ~77

Retrieve message history with a counterpart.

NameTypeReqDescription
candidate_idstringyesCandidate pair ID
cursorstring
limitnumberMax messages (default 50)
sincestringISO 8601 timestamp — only messages after this time
user_tokenstringyesYour bearer token

No output schema declared.

No examples provided.

schelling.my_insights ~44

Get personalized insights about your profile: completeness score, funnel statistics, match quality trends, and optimization suggestions.

NameTypeReqDescription
user_tokenstringyesYour bearer token

No output schema declared.

No examples provided.

schelling.notifications ~63

Check notifications from your push-based discovery subscriptions.

NameTypeReqDescription
limitnumberMax notifications
sincestringISO 8601 timestamp filter
subscription_idstringFilter by subscription
user_tokenstringyesYour bearer token

No output schema declared.

No examples provided.

schelling.onboard ~98

Start using Schelling with zero configuration. Describe what you need in plain English and get back a registration template with suggested cluster, traits, and preferences. The easiest way to get started.

NameTypeReqDescription
cluster_idstringTarget cluster (auto-detected from your description if omitted)
natural_languagestringyesWhat you want in plain English (e.g. 'I need a React developer in Denver, $120/hr')

No output schema declared.

No examples provided.

schelling.pending ~42

Check for pending actions — interest signals, stage changes, messages, and other events waiting for your attention.

NameTypeReqDescription
user_tokenstringyesYour bearer token

No output schema declared.

No examples provided.

schelling.quick_match ~87

Submit both sides of a coordination problem for instant matching. Provide a seeker and offerer profile and get an immediate compatibility assessment.

NameTypeReqDescription
auto_connectbooleanAuto-connect if match quality is high
offerOfferer profile: {intent, traits?, cluster_id?}
seekSeeker profile: {intent, traits?, preferences?, cluster_id?}

No output schema declared.

No examples provided.

schelling.quick_offer ~167

Advertise a service or capability in one call. Describe what you offer and get matched with seekers. Auto-registers and optionally subscribes to incoming requests.

NameTypeReqDescription
auto_subscribebooleanAuto-subscribe to matching seekers (default true)
available_untilstringISO 8601 availability deadline
cluster_idstringTarget cluster (auto-detected if omitted)
intentstringyesWhat you're offering in plain English (e.g. 'I do React development, 5 years experience, Denver, $90/hr')
notification_thresholdnumberMinimum fit score for notifications (0-1)
traitsStructured traits for your offering
user_tokenstringBearer token (auto-registers if omitted)

No output schema declared.

No examples provided.

schelling.quick_seek ~188

Find what you need in one call. Describe your requirements in natural language or structured format. Auto-registers you if needed and returns ranked candidates immediately. The fastest way to search.

NameTypeReqDescription
auto_advancebooleanAuto-advance top candidates to INTERESTED stage
budgetBudget constraints: {min?, max?, currency?}
cluster_idstringTarget cluster (auto-detected if omitted)
constraintsStructured constraints as preference objects
deadlinestringISO 8601 deadline for urgency
intentstringyesWhat you're looking for in plain English (e.g. 'Python developer, 5+ years, remote, under $100/hr')
max_resultsnumberMax candidates to return (default 5)
user_tokenstringBearer token (auto-registers you if omitted)

No output schema declared.

No examples provided.

schelling.reconsider ~55

Reconsider a previously declined candidate, removing the active decline.

NameTypeReqDescription
candidate_idstringyesCandidate pair ID
idempotency_keystring
user_tokenstringyesYour bearer token

No output schema declared.

No examples provided.

schelling.refresh ~46

Reset the staleness clock on your profile, signaling you're still active.

NameTypeReqDescription
idempotency_keystring
user_tokenstringyesYour bearer token

No output schema declared.

No examples provided.

schelling.register ~310

Register a participant in the coordination network with structured traits and preferences. Use schelling.onboard first to get a template, then pass it here.

NameTypeReqDescription
agent_capabilitiesarrayAgent capabilities
agent_modelstringAI model identifier
cluster_idstringyesCluster to register in (e.g. 'hiring.engineering.frontend')
funnel_modestringCoordination mode (default: bilateral)
group_sizenumberTarget group size for group mode (2-50)
idempotency_keystringIdempotency key to prevent duplicates
identityIdentity info: {name?, contact?, phone_hash?}
intent_embeddingarray16-dimensional intent vector
intentsarrayNatural language intent descriptions (max 5)
media_refsarrayURLs to photos/media
phone_hashstringSHA-256 hash of phone for Sybil resistance
preferencesarrayArray of preference objects: [{trait_key, operator, value, weight}]
protocol_versionstringyesMust be '3.0'
rolestringRole within the cluster (cluster-defined)
text_profileFree text: {description?, seeking?, interests?, values_text?}
traitsarrayArray of trait objects: [{key, value, value_type, visibility}]
user_tokenstringExisting token for re-registration

No output schema declared.

No examples provided.

schelling.register_tool ~191

Register a third-party tool in the Schelling ecosystem. Tools extend coordination capabilities — skill assessments, background checks, portfolio reviews, and more.

NameTypeReqDescription
cluster_scopearrayClusters this tool applies to
descriptionstringyesFull description
display_namestringyesHuman-readable name
endpointstringyesHTTPS endpoint for tool invocation
health_check_endpointstring
idempotency_keystring
input_schemaJSON Schema for tool input
one_line_descriptionstringyesOne-line summary
output_schemaJSON Schema for tool output
pricingPricing: {model, amount?, currency?}
tool_idstringyesNamespaced tool ID: {developer}.{tool_name}
user_tokenstringyesDeveloper bearer token
versionstringyesSemantic version

No output schema declared.

No examples provided.

schelling.relay_block ~58

Block or unblock message relay from a specific counterpart.

NameTypeReqDescription
blockedbooleanyestrue to block, false to unblock
candidate_idstringyesCandidate pair ID
user_tokenstringyesYour bearer token

No output schema declared.

No examples provided.

schelling.report ~84

Report the outcome of a connection — positive, neutral, or negative. This feeds the learned ranking model and reputation system.

NameTypeReqDescription
candidate_idstringyesCandidate pair ID
feedbackStructured feedback
idempotency_keystring
outcomestringyesHow the coordination went
user_tokenstringyesYour bearer token

No output schema declared.

No examples provided.

schelling.reputation ~62

Check reputation scores — your own or a counterpart's. Shows trust level, interaction history, and cross-cluster reputation.

NameTypeReqDescription
candidate_idstringCandidate pair ID to check counterpart's reputation
user_tokenstringyesYour bearer token

No output schema declared.

No examples provided.

schelling.search ~178

Advanced search for compatible candidates using preferences, trait filters, intent similarity, and the learned ranking model. Supports natural language queries alongside structured filters.

NameTypeReqDescription
capability_filtersarrayRequired agent capabilities
cluster_idstringCluster to search (defaults to your cluster)
cursorstringPagination cursor
idempotency_keystring
max_resultsnumberMax results (default 20)
min_advisory_scorenumberMinimum match score threshold (0-1)
mode_filterstringFilter by coordination mode
natural_languagestringNatural language search query
preference_overridesarrayTemporary preference overrides for this search
trait_filtersarrayHard trait filters
user_tokenstringyesYour bearer token

No output schema declared.

No examples provided.

schelling.server_info ~27

Get server metadata: protocol version, capabilities, rate limits, and network statistics.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

schelling.subscribe ~165

Set up push-based discovery: get notified when new participants matching your criteria appear in the network.

NameTypeReqDescription
actionstringCreate a subscription or list existing ones
capability_filtersarrayRequired capabilities
cluster_filterstringCluster to watch
idempotency_keystring
intent_embeddingarray16-dim intent vector for similarity matching
max_notifications_per_daynumberDaily notification cap
mode_filterstringFunnel mode filter
thresholdnumberMinimum match score for notification (0-1)
trait_filtersarrayTrait-based filters
ttl_daysnumberSubscription lifetime in days
user_tokenstringyesYour bearer token

No output schema declared.

No examples provided.

schelling.tool_feedback ~72

Rate a tool invocation — helps the ecosystem surface the best tools.

NameTypeReqDescription
commentstringOptional feedback
invocation_idstring
ratingstringyesYour rating
tool_idstringyesTool to rate
user_tokenstringyesYour bearer token

No output schema declared.

No examples provided.

schelling.tool_invoke ~56

Invoke a tool from the ecosystem (built-in or third-party).

NameTypeReqDescription
inputTool-specific input payload
tool_idstringyesTool to invoke
user_tokenstringyesYour bearer token

No output schema declared.

No examples provided.

schelling.unsubscribe ~39

Cancel a push-based discovery subscription.

NameTypeReqDescription
subscription_idstringyesSubscription to cancel
user_tokenstringyesYour bearer token

No output schema declared.

No examples provided.

schelling.update ~148

Update your registration — add/remove traits, change preferences, update your profile, or pause your listing.

NameTypeReqDescription
idempotency_keystring
intent_embeddingarrayUpdated 16-dim intent vector
intentsarrayUpdated intent descriptions
preferencesarrayPreferences to upsert
remove_preferencesarrayPreference trait_keys to remove
remove_traitsarrayTrait keys to remove
statusstringSet status (paused hides from search)
text_profileUpdated text profile
traitsarrayTraits to upsert
user_tokenstringyesYour bearer token from registration

No output schema declared.

No examples provided.

schelling.verify ~124

Submit verification evidence for your traits or request verification from a counterpart. Verified traits build trust.

NameTypeReqDescription
actionstringyesSubmit your own evidence or request from counterpart
candidate_idstringCandidate pair ID (for request action)
evidence_datastringEvidence payload
evidence_typestringType of evidence
idempotency_keystring
requested_tierstringRequested verification level
trait_keystringyesTrait key to verify
user_tokenstringyesYour bearer token

No output schema declared.

No examples provided.

schelling.withdraw ~69

Withdraw from a COMMITTED or CONNECTED match, resetting to INTERESTED stage.

NameTypeReqDescription
candidate_idstringyesCandidate pair ID
idempotency_keystring
reasonstringReason for withdrawal
user_tokenstringyesYour bearer token

No output schema declared.

No examples provided.