Search / io.github.x207-labs/x207-mcp
x207
R0· no sign-inRead-only tools for x207 circles on NEAR: members, epochs, clearing simulation, listings.
v0.0.6 · active · repository · website · descriptor JSON · versions
Search / io.github.x207-labs/x207-mcp
R0· no sign-inRead-only tools for x207 circles on NEAR: members, epochs, clearing simulation, listings.
v0.0.6 · active · repository · website · descriptor JSON · versions
{
"mcpServers": {
"x207-mcp": {
"type": "http",
"url": "https://mcp.x207.boxd.sh/mcp"
}
}
}claude mcp add --transport http x207-mcp https://mcp.x207.boxd.sh/mcp[mcp_servers.x207-mcp]
url = "https://mcp.x207.boxd.sh/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"x207-mcp": {
"type": "remote",
"url": "https://mcp.x207.boxd.sh/mcp",
"enabled": true
}
}
}{
"mcpServers": {
"x207-mcp": {
"type": "http",
"url": "https://mcp.x207.boxd.sh/mcp"
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=x207-mcp&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vbWNwLngyMDcuYm94ZC5zaC9tY3AifQ%3D%3D"
}{
"servers": {
"x207-mcp": {
"type": "http",
"url": "https://mcp.x207.boxd.sh/mcp"
}
}
}{
"mcpServers": {
"x207-mcp": {
"httpUrl": "https://mcp.x207.boxd.sh/mcp"
}
}
}extensions:
"x207-mcp":
enabled: true
name: "x207-mcp"
type: streamable_http
uri: "https://mcp.x207.boxd.sh/mcp"
timeout: 300
protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28protocol.statelessonly applies to 2026-07-28 serversprotocol.transportstreamable HTTPprotocol.list_ttlonly applies to 2026-07-28 serversauth.prm, auth.as_metadata, auth.cimdno remote uses OAuthauth.secret_in_urlno templated URLtools.descriptionsevery tool has a descriptiontools.description_lengthdescriptions are concisetools.schemasevery tool has an object input schematools.annotations6 of 6 tools declare readOnlyHint or destructiveHinttools.directory_hintsevery tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHinttools.token_costabout 1,884 tokens to load every tooltools.api_dumptools are not a one-to-one API dumpstability.changes, stability.rug_pulltool history recorded for 2 of the 7 days neededdeps.known_vulns, deps.mcp_sdk_version, deps.resolvabledeps.dev does not know @x207/[email protected]x207_order_statuschangeddescription, input schemameaning changedA service order of the circle's marketplace: parties, budget, milestones and status (read API GET /orders/{hash}). Without a hash, lists orders; filter by `party` and `status`.
Orders of the circle's marketplace (read API GET /orders). With a hash: one order with its parties, budget, milestones and status. Without a hash: a page of orders, filtered by party and status. Use x207_search_listings to find offers before an order exists. An unknown hash is an error ("no order ... in circle"); an empty list is a normal result. Needs the read API (X207_BACKEND_URL).
x207_search_listingschangeddescription, input schemameaning changedListings of the circle's marketplace (read API GET /listings): what an account offers and what it wants. Filters are optional; `status` defaults to open. Use `cursor` from `nextCursor` for the next page.
Find offers on the circle's marketplace (read API GET /listings): what an account offers and what it wants. Use it to discover who sells a service; for an order that already exists use x207_order_status. Returns {items, nextCursor}; pass nextCursor as `cursor` for the next page. No match gives an empty list, not an error. Needs the read API (X207_BACKEND_URL) and fails with a clear message without it.
x207_simulate_clearingchangeddescription, input schemameaning changedAsks the contract (view simulate_clearing) whether a proposed clearing for an epoch is valid and what it would clear. Each edge nets a debt: debtor owes creditor, `cleared` is the amount to cancel (decimal string, smallest unit). Changes nothing.
Dry run of a netting proposal: asks the contract (view simulate_clearing) whether the edges would be accepted for an epoch and how much debt they would cancel. Use it to check a proposal before a solver submits it; to see what a finished epoch actually netted use x207_epoch_report. Returns {epoch, edgeCount, result}. An invalid proposal (unknown member, amount above the debt, wrong epoch phase) comes back as an error text from the contract. Read-only, sends nothing.
x207_epoch_reportchangeddescription, input schemameaning changedThe state and the result of one clearing epoch: the contract record (get_epoch) and, from the read API, the epoch summary (GET /epochs/{n}), its metrics (cleared ratio, GET /epochs/{n}/metrics) and its settlements (GET /epochs/{n}/settlements). Without epoch, the current epoch.
One epoch of the circle: its phase and deadlines from the contract (get_epoch), and from the read API the summary, the metrics (cleared ratio: the share of debt that netting removed, so only the net cash moves) and the settlements, i.e. who owes whom what in cash. Use it after an epoch closed; use x207_simulate_clearing to test a proposal before it is submitted. Returns {epoch, contract, summary, metrics, settlements, source, warnings}. An epoch that does not exist is an error; if the read API is down the contract record is still returned, with the failures in `warnings`.
x207_member_inspectchangeddescription, input schemameaning changedOne member of the circle: status, stake, position and credit limit. Uses the read API (GET /members/{account} and /members/{account}/limits), or the contract views member and limit when no read API is configured.
One member of the circle: status, stake, outstanding debt and credit limit (read API GET /members/{account} and /limits, or the contract views member and limit when no read API is set). Use it after x207_circle_overview has shown the account ids, or before paying a member; for epoch-level amounts use x207_epoch_report. Returns {account, member, limits|limit, source, warnings}. An account that is not a member is an error ("not a member" or a 404 from the read API); a failed limits lookup is only a warning.
x207_circle_overviewchangeddescription, input schemameaning changedOverview of one x207 mutual-credit circle: its record and rules from the contract (get_circle, get_params) and its members (read API GET /members, or the contract view list_members when no read API is configured). Credit amounts are strings in the smallest unit (6 decimals).
Start here: the circle itself, i.e. its record and rules (get_circle, get_params) plus a page of its members (read API GET /members, or the contract view list_members when no read API is set). Use x207_member_inspect for one member in detail and x207_epoch_report for one epoch. Returns {contract, circleId, circle, params, members, membersSource, warnings}; amounts are strings in the smallest unit (6 decimals). If the members part fails it shows up in `warnings` and the rest is still returned; an unreachable contract RPC is an error.
Full history: list_changes · trend: quality JSON.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+repository +namespace-matches-repo +website +reachable +uptime-100% +updated-2d-ago
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
@x207/[email protected] npmthis version is not known to the dependency resolver
Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.
| remote | auth | reachable | uptime 30d | p50 | protocol | last ok |
|---|---|---|---|---|---|---|
https://mcp.x207.boxd.sh/mcp streamable-http | none | yes | 100% | 965 ms | 2025-11-25 | 2026-11-07 |
| package | registry | version | runtime | secrets |
|---|---|---|---|---|
@x207/mcp | npm | 0.0.6 | – |
x207_circle_overviewread-only | Start here: the circle itself, i.e. its record and rules (get_circle, get_params) plus a page of its members (read API GET /members, or the contract view list_members when no read API is set). Use x207_member_inspect for one member in detail and x207_epoch_report for one epoch. Returns {contract, circleId, circle, params, members, membersSource, warnings}; amounts are strings in the smallest unit (6 decimals). If the members part fails it shows up in `warnings` and the rest is still returned; an unreachable contract RPC is an error. |
x207_epoch_reportread-only | One epoch of the circle: its phase and deadlines from the contract (get_epoch), and from the read API the summary, the metrics (cleared ratio: the share of debt that netting removed, so only the net cash moves) and the settlements, i.e. who owes whom what in cash. Use it after an epoch closed; use x207_simulate_clearing to test a proposal before it is submitted. Returns {epoch, contract, summary, metrics, settlements, source, warnings}. An epoch that does not exist is an error; if the read API is down the contract record is still returned, with the failures in `warnings`. |
x207_member_inspectread-only | One member of the circle: status, stake, outstanding debt and credit limit (read API GET /members/{account} and /limits, or the contract views member and limit when no read API is set). Use it after x207_circle_overview has shown the account ids, or before paying a member; for epoch-level amounts use x207_epoch_report. Returns {account, member, limits|limit, source, warnings}. An account that is not a member is an error ("not a member" or a 404 from the read API); a failed limits lookup is only a warning. |
x207_order_statusread-only | Orders of the circle's marketplace (read API GET /orders). With a hash: one order with its parties, budget, milestones and status. Without a hash: a page of orders, filtered by party and status. Use x207_search_listings to find offers before an order exists. An unknown hash is an error ("no order ... in circle"); an empty list is a normal result. Needs the read API (X207_BACKEND_URL). |
x207_search_listingsread-only | Find offers on the circle's marketplace (read API GET /listings): what an account offers and what it wants. Use it to discover who sells a service; for an order that already exists use x207_order_status. Returns {items, nextCursor}; pass nextCursor as `cursor` for the next page. No match gives an empty list, not an error. Needs the read API (X207_BACKEND_URL) and fails with a clear message without it. |
x207_simulate_clearingread-only | Dry run of a netting proposal: asks the contract (view simulate_clearing) whether the edges would be accepted for an epoch and how much debt they would cancel. Use it to check a proposal before a solver submits it; to see what a finished epoch actually netted use x207_epoch_report. Returns {epoch, edgeCount, result}. An invalid proposal (unknown member, amount above the debt, wrong epoch phase) comes back as an error text from the contract. Read-only, sends nothing. |
Schemas: list_tools.
{
"name": "io.github.x207-labs/x207-mcp",
"title": "x207",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"remotes": [
{
"url": "https://mcp.x207.boxd.sh/mcp",
"type": "streamable-http"
}
],
"version": "0.0.6",
"packages": [
{
"version": "0.0.6",
"transport": {
"type": "stdio"
},
"identifier": "@x207/mcp",
"registryType": "npm"
}
],
"repository": {
"url": "https://github.com/x207-labs/sdk",
"source": "github",
"subfolder": "packages/mcp"
},
"websiteUrl": "https://github.com/x207-labs/x207#readme",
"description": "Read-only tools for x207 circles on NEAR: members, epochs, clearing simulation, listings."
}