7Maps

Use this after calling a tool on an MCP server (especially one 7Maps pointed you to) to report how it went: whether it worked, why not, how long it took, whether the result matched the description, and anything it did that you did not ask for. Fixed fields only, no open text. Reports from many agents become the server's rating and, once 7Maps confirms them, live incident alerts that every agent sees. You can also pass the same fields as last_trip on any paid 7Maps call. No charge.

{
  "type": "object",
  "properties": {
    "server": {
      "type": "string",
      "minLength": 3,
      "maxLength": 300,
      "description": "The MCP server you called (URL or registry name)"
    },
    "tool": {
      "description": "The tool you called",
      "type": "string",
      "maxLength": 120
    },
    "ok": {
      "type": "boolean",
      "description": "Whether the call did what you needed"
    },
    "fail": {
      "description": "If it failed: unreachable, auth, args, server_error, timeout, rate_limited or wrong_result",
      "type": "string",
      "enum": [
        "unreachable",
        "auth",
        "args",
        "server_error",
        "timeout",
        "rate_limited",
        "wrong_result"
      ]
    },
    "ms": {
      "description": "How long the call took, in milliseconds",
      "type": "number",
      "minimum": 0,
      "maximum": 600000
    },
    "matched_description": {
      "description": "Whether the result matched what the tool description promised",
      "type": "boolean"
    },
    "result_tokens": {
      "description": "About how many tokens the result was",
      "type": "number",
      "minimum": 0,
      "maximum": 5000000
    },
    "charged_usd": {
      "description": "What the server charged, if anything",
      "type": "number",
      "minimum": 0,
      "maximum": 1000
    },
    "surprise": {
      "description": "Anything the tool did that you did not ask for",
      "type": "string",
      "enum": [
        "side_effect",
        "unexpected_cost",
        "data_leak_suspected",
        "other"
      ]
    },
    "tools_hash": {
      "description": "The tool_list_hash of the tool list you received, if you computed it as 7Maps does",
      "type": "string",
      "maxLength": 64
    }
  },
  "required": [
    "server",
    "ok"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Use this when someone has built or runs an MCP server that is not in the official MCP registry (for example a small business's own server) and wants AI agents to be able to find it, or asks how to get their server listed. Give the server address, or just the business's domain and the usual endpoint paths are tried. The server is observed every 6 hours for 7 days; if it answers reliably, keeps its tools stable and describes every tool, it joins the 7Maps map that agents use to choose servers. Placement cannot be bought. Returns the status page and an optional owner-verification token. No charge.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "minLength": 3,
      "maxLength": 300,
      "description": "The MCP server address, or the business domain (example.com)"
    },
    "category": {
      "description": "What the business does; agents also see the category its tools show",
      "type": "string",
      "enum": [
        "commerce",
        "booking",
        "payments",
        "marketing",
        "crm",
        "documents",
        "data",
        "dev",
        "realestate",
        "health",
        "travel",
        "legal",
        "other"
      ]
    },
    "about": {
      "description": "One sentence: what the business does and for whom",
      "type": "string",
      "maxLength": 200
    },
    "country": {
      "description": "Where the business serves customers",
      "type": "string",
      "maxLength": 40
    },
    "language": {
      "description": "Main language of the tools and their data",
      "type": "string",
      "maxLength": 30
    },
    "charges": {
      "description": "Whether the server charges agents (x402 or a subscription)",
      "type": "boolean"
    }
  },
  "required": [
    "url"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Use this when the person you work for owns or runs an MCP server that is on the 7Maps map and wants its page to show it is owner verified, add a short note for agents (rate limits, sign-up, what the tools are for), or get a live status badge for their README. Verified owners' servers are checked every 5 minutes (uptime on the page and badge), and with alert_url the owner gets a message when the server stops answering and when it is back. First call returns the proof options (a line in /.well-known/7maps-verify.txt on the server's host, a DNS TXT record, or for io.github registry names a file in the GitHub repo); after one is in place, call again to confirm. Verifying does not change how the server is measured or ranked. No charge.

{
  "type": "object",
  "properties": {
    "server": {
      "type": "string",
      "minLength": 3,
      "maxLength": 300,
      "description": "The MCP server address as it appears on its 7Maps page"
    },
    "note": {
      "description": "Optional plain-text note from the owner, no links, up to 280 characters",
      "type": "string",
      "maxLength": 280
    },
    "alert_url": {
      "description": "Optional: where to send down and up alerts. An ntfy topic for phone push without email (https://ntfy.sh/<hard-to-guess topic, at least 10 characters>, a self-hosted https://ntfy.<domain>/<topic>, or ntfy:https://<host>/<topic>), a Slack incoming webhook (https://hooks.slack.com/services/...), a Discord webhook (https://discord.com/api/webhooks/...), or any https webhook that receives JSON. Stored encrypted, saved only once ownership is proven; a test message is sent on save. An empty string turns alerts off.",
      "type": "string",
      "maxLength": 600
    }
  },
  "required": [
    "server"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Use this when the person you work for owns an MCP server on the 7Maps map and wants to know how AI agents look for servers like it: how often agents asked 7Maps for servers in its category in the last 7 or 30 days, how often this server was shown and picked, and, for a verified owner with owner_key, the words agents used, the servers picked instead, failure reasons agents reported, uptime, tool changes, and its token cost and handshake time against similar servers. Counts only, no agent identities. Without owner_key it returns the public numbers and how to verify ownership with claim_mcp_server. Read-only; never changes ranking or routing. No charge.

{
  "type": "object",
  "properties": {
    "server": {
      "type": "string",
      "minLength": 3,
      "maxLength": 300,
      "description": "The MCP server address as it appears on its 7Maps page, or its official registry name"
    },
    "owner_key": {
      "description": "The owner key returned to the verified owner by claim_mcp_server",
      "type": "string",
      "maxLength": 64
    },
    "days": {
      "description": "Window in days: 7 (default) or 30",
      "anyOf": [
        {
          "type": "number",
          "const": 7
        },
        {
          "type": "number",
          "const": 30
        }
      ]
    }
  },
  "required": [
    "server"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Use this when the person you work for asks what 7Maps has done for them: calls made with their personal 7Maps key today, in the last 7 days and in the last 30 days, servers checked, an estimate of the tokens saved compared with finding the same thing out without 7Maps, failures avoided (servers not answering that were skipped, risk changes caught by watch or verify_lock, calls that would have failed) and the average response time. It reads the optional personal key sent with this connection (the X-7Maps-Key header); without one it says so in one line, since every 7Maps answer already states its own saving. Only that person's own counts. No charge.

{
  "type": "object",
  "properties": {
    "window": {
      "description": "Which window to lead with: day (today), week (last 7 days) or month (last 30 days); all three are returned",
      "type": "string",
      "enum": [
        "day",
        "week",
        "month"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Use this when you need a tool for a job and do not know which MCP server has one: searches every tool of every public MCP server on the 7Maps map (over 200,000 tools, probed daily) and returns the best matches with an automated estimate of what each tool can do (read-only, changes data, high risk), whether its server is answering now, its handshake time, the tokens its tool list costs to load, and a page to check it. Filter to read-only tools, servers answering now, a latency or token ceiling. Copies of the same tool on several servers are collapsed. No charge. To have 7Maps pick one server and tool for you with alternatives, use route.

{
  "type": "object",
  "properties": {
    "job": {
      "type": "string",
      "minLength": 3,
      "maxLength": 200,
      "description": "What the tool should do, in plain words, for example \"send a transactional email\" or \"query a postgres database\""
    },
    "may": {
      "description": "What the tool may do: read = read-only only; change = read or change data; any = include high-risk tools (default any)",
      "type": "string",
      "enum": [
        "read",
        "change",
        "any"
      ]
    },
    "answering_now": {
      "description": "Only servers that answered with tools on the last check (default true)",
      "type": "boolean"
    },
    "max_handshake_ms": {
      "type": "integer",
      "minimum": 50,
      "maximum": 30000
    },
    "max_tool_list_tokens": {
      "type": "integer",
      "minimum": 100,
      "maximum": 200000
    },
    "limit": {
      "description": "How many results (default 10)",
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    }
  },
  "required": [
    "job"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "tool": {
            "type": "string"
          },
          "server": {
            "type": "string"
          },
          "does": {
            "type": "string"
          },
          "status": {
            "type": "string"
          }
        },
        "required": [
          "tool",
          "server",
          "does",
          "status"
        ],
        "additionalProperties": {}
      }
    },
    "matched": {
      "type": "number"
    },
    "tools_indexed": {
      "type": "number"
    }
  },
  "required": [
    "results",
    "matched",
    "tools_indexed"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": {}
}

Use this before calling a paid 7IT tool, to see what each costs and how to pay: per call in USDC on Base via x402 (no account; for agents whose owner approved a budget in advance), or a monthly plan license key. No charge; returns prices, plans and payment details.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

{
  "type": "object",
  "properties": {
    "open": {
      "type": "boolean"
    },
    "network": {
      "type": "string"
    },
    "tools": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "tool": {
            "type": "string"
          },
          "usd": {
            "type": "number"
          },
          "unit": {
            "type": "string"
          }
        },
        "required": [
          "tool",
          "usd",
          "unit"
        ],
        "additionalProperties": {}
      }
    },
    "plans": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "usd_per_month": {
            "type": "number"
          }
        },
        "required": [
          "name",
          "usd_per_month"
        ],
        "additionalProperties": {}
      }
    }
  },
  "required": [
    "open",
    "tools",
    "plans"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": {}
}

Use this when deciding whether to use 7Maps, or when asked what it is: what the map covers right now, what each 7Maps tool answers, what a call costs, and how it saves an agent tokens, time and failed calls compared with connecting to MCP servers blind. Includes a live worked example on a real server from the map (changes daily), and, if you name a server, a quote of what 7Maps would save you on it (tokens and time) before you pay. No charge.

{
  "type": "object",
  "properties": {
    "server": {
      "description": "A server you are considering: get a quote of the tokens and time 7Maps would save on it, before paying",
      "type": "string",
      "maxLength": 300
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Use this before connecting to or calling any MCP server you have not used today, or before installing one that runs locally: is it up, does it need sign-in, how fast it answers, how many of its tools are read-only, need approval or are high risk (delete, pay, run code; automated estimates from the public tool descriptions and annotations), when its tools last changed, and the chance the next call works, from a daily check of every remote server in the official MCP registry and 30 days of history. For a local server (npm or PyPI package): version, maintainers, publisher, install scripts and supply-chain changes. Paid per check (see list_paid_tools). Reads the map only; never calls the server.

{
  "type": "object",
  "properties": {
    "server": {
      "type": "string",
      "minLength": 3,
      "maxLength": 300,
      "description": "The server URL (https://mcp.example.com/mcp), its official registry name, or npm:<package> / pypi:<package> for a server that runs locally"
    },
    "license_key": {
      "description": "A 7IT monthly plan license key, if you have one; otherwise pay per call with x402",
      "type": "string",
      "maxLength": 100
    },
    "last_trip": {
      "description": "Optional: how your last call to an MCP server went (the one 7Maps pointed you to). It keeps the map honest; accepted reports from a paying wallet earn calls at no charge.",
      "type": "object",
      "properties": {
        "server": {
          "type": "string",
          "minLength": 3,
          "maxLength": 300,
          "description": "The MCP server you called (URL or registry name)"
        },
        "tool": {
          "description": "The tool you called",
          "type": "string",
          "maxLength": 120
        },
        "ok": {
          "type": "boolean",
          "description": "Whether the call did what you needed"
        },
        "fail": {
          "description": "If it failed: unreachable, auth, args, server_error, timeout, rate_limited or wrong_result",
          "type": "string",
          "enum": [
            "unreachable",
            "auth",
            "args",
            "server_error",
            "timeout",
            "rate_limited",
            "wrong_result"
          ]
        },
        "ms": {
          "description": "How long the call took, in milliseconds",
          "type": "number",
          "minimum": 0,
          "maximum": 600000
        },
        "matched_description": {
          "description": "Whether the result matched what the tool description promised",
          "type": "boolean"
        },
        "result_tokens": {
          "description": "About how many tokens the result was",
          "type": "number",
          "minimum": 0,
          "maximum": 5000000
        },
        "charged_usd": {
          "description": "What the server charged, if anything",
          "type": "number",
          "minimum": 0,
          "maximum": 1000
        },
        "surprise": {
          "description": "Anything the tool did that you did not ask for",
          "type": "string",
          "enum": [
            "side_effect",
            "unexpected_cost",
            "data_leak_suspected",
            "other"
          ]
        },
        "tools_hash": {
          "description": "The tool_list_hash of the tool list you received, if you computed it as 7Maps does",
          "type": "string",
          "maxLength": 64
        }
      },
      "required": [
        "server",
        "ok"
      ]
    }
  },
  "required": [
    "server"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Use this before reusing an MCP server that a person approved earlier: tells whether its tools changed since that date, and whether any change raised the risk (a tool that now deletes, pays or runs code), including silent changes made without a new server version. If the risk went up, ask the person to approve again before calling it. Paid per check (see list_paid_tools). Reads the map only.

{
  "type": "object",
  "properties": {
    "server": {
      "type": "string",
      "minLength": 3,
      "maxLength": 300,
      "description": "The server URL, its official registry name, or npm:<package> / pypi:<package>"
    },
    "approved_at": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}",
      "description": "When the person approved this server (YYYY-MM-DD)"
    },
    "license_key": {
      "description": "A 7IT monthly plan license key, if you have one; otherwise pay per call with x402",
      "type": "string",
      "maxLength": 100
    },
    "last_trip": {
      "description": "Optional: how your last call to an MCP server went (the one 7Maps pointed you to). It keeps the map honest; accepted reports from a paying wallet earn calls at no charge.",
      "type": "object",
      "properties": {
        "server": {
          "type": "string",
          "minLength": 3,
          "maxLength": 300,
          "description": "The MCP server you called (URL or registry name)"
        },
        "tool": {
          "description": "The tool you called",
          "type": "string",
          "maxLength": 120
        },
        "ok": {
          "type": "boolean",
          "description": "Whether the call did what you needed"
        },
        "fail": {
          "description": "If it failed: unreachable, auth, args, server_error, timeout, rate_limited or wrong_result",
          "type": "string",
          "enum": [
            "unreachable",
            "auth",
            "args",
            "server_error",
            "timeout",
            "rate_limited",
            "wrong_result"
          ]
        },
        "ms": {
          "description": "How long the call took, in milliseconds",
          "type": "number",
          "minimum": 0,
          "maximum": 600000
        },
        "matched_description": {
          "description": "Whether the result matched what the tool description promised",
          "type": "boolean"
        },
        "result_tokens": {
          "description": "About how many tokens the result was",
          "type": "number",
          "minimum": 0,
          "maximum": 5000000
        },
        "charged_usd": {
          "description": "What the server charged, if anything",
          "type": "number",
          "minimum": 0,
          "maximum": 1000
        },
        "surprise": {
          "description": "Anything the tool did that you did not ask for",
          "type": "string",
          "enum": [
            "side_effect",
            "unexpected_cost",
            "data_leak_suspected",
            "other"
          ]
        },
        "tools_hash": {
          "description": "The tool_list_hash of the tool list you received, if you computed it as 7Maps does",
          "type": "string",
          "maxLength": 64
        }
      },
      "required": [
        "server",
        "ok"
      ]
    }
  },
  "required": [
    "server",
    "approved_at"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Use this when you need a tool for a task and do not know which MCP server to use, or when several could do it: finds servers whose tools match the task and ranks them by the chance the call works, how stable the server is, and least privilege (a server that can do less harm than another is preferred when both can do the task). Returns the best server and tool, alternatives and servers to avoid. Paid per task (see list_paid_tools). Reads the map only.

{
  "type": "object",
  "properties": {
    "task": {
      "type": "string",
      "minLength": 3,
      "maxLength": 300,
      "description": "What you need to do, for example \"send a transactional email\" or \"search company records\""
    },
    "need": {
      "description": "How much the task must be allowed to do: read only, change something, or a high-risk action such as payments or deletion. Guessed from the task when omitted",
      "type": "string",
      "enum": [
        "read",
        "change",
        "high_risk"
      ]
    },
    "license_key": {
      "description": "A 7IT monthly plan license key, if you have one; otherwise pay per call with x402",
      "type": "string",
      "maxLength": 100
    },
    "last_trip": {
      "description": "Optional: how your last call to an MCP server went (the one 7Maps pointed you to). It keeps the map honest; accepted reports from a paying wallet earn calls at no charge.",
      "type": "object",
      "properties": {
        "server": {
          "type": "string",
          "minLength": 3,
          "maxLength": 300,
          "description": "The MCP server you called (URL or registry name)"
        },
        "tool": {
          "description": "The tool you called",
          "type": "string",
          "maxLength": 120
        },
        "ok": {
          "type": "boolean",
          "description": "Whether the call did what you needed"
        },
        "fail": {
          "description": "If it failed: unreachable, auth, args, server_error, timeout, rate_limited or wrong_result",
          "type": "string",
          "enum": [
            "unreachable",
            "auth",
            "args",
            "server_error",
            "timeout",
            "rate_limited",
            "wrong_result"
          ]
        },
        "ms": {
          "description": "How long the call took, in milliseconds",
          "type": "number",
          "minimum": 0,
          "maximum": 600000
        },
        "matched_description": {
          "description": "Whether the result matched what the tool description promised",
          "type": "boolean"
        },
        "result_tokens": {
          "description": "About how many tokens the result was",
          "type": "number",
          "minimum": 0,
          "maximum": 5000000
        },
        "charged_usd": {
          "description": "What the server charged, if anything",
          "type": "number",
          "minimum": 0,
          "maximum": 1000
        },
        "surprise": {
          "description": "Anything the tool did that you did not ask for",
          "type": "string",
          "enum": [
            "side_effect",
            "unexpected_cost",
            "data_leak_suspected",
            "other"
          ]
        },
        "tools_hash": {
          "description": "The tool_list_hash of the tool list you received, if you computed it as 7Maps does",
          "type": "string",
          "maxLength": 64
        }
      },
      "required": [
        "server",
        "ok"
      ]
    }
  },
  "required": [
    "task"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Use this instead of loading a server's full tool definitions when you only need to choose a tool or prepare a call: one compact card per tool (what it does, its arguments with required ones marked *, risk level and side effects) plus a hash of the full definition. Usually 70 to 90% fewer tokens than the server's own tool list. Optionally only the named tools. Paid per server (see list_paid_tools). Reads the map only.

{
  "type": "object",
  "properties": {
    "server": {
      "type": "string",
      "minLength": 3,
      "maxLength": 300,
      "description": "The server URL or its official registry name"
    },
    "tools": {
      "description": "Only these tools; all when omitted",
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 120
      }
    },
    "license_key": {
      "description": "A 7IT monthly plan license key, if you have one; otherwise pay per call with x402",
      "type": "string",
      "maxLength": 100
    },
    "last_trip": {
      "description": "Optional: how your last call to an MCP server went (the one 7Maps pointed you to). It keeps the map honest; accepted reports from a paying wallet earn calls at no charge.",
      "type": "object",
      "properties": {
        "server": {
          "type": "string",
          "minLength": 3,
          "maxLength": 300,
          "description": "The MCP server you called (URL or registry name)"
        },
        "tool": {
          "description": "The tool you called",
          "type": "string",
          "maxLength": 120
        },
        "ok": {
          "type": "boolean",
          "description": "Whether the call did what you needed"
        },
        "fail": {
          "description": "If it failed: unreachable, auth, args, server_error, timeout, rate_limited or wrong_result",
          "type": "string",
          "enum": [
            "unreachable",
            "auth",
            "args",
            "server_error",
            "timeout",
            "rate_limited",
            "wrong_result"
          ]
        },
        "ms": {
          "description": "How long the call took, in milliseconds",
          "type": "number",
          "minimum": 0,
          "maximum": 600000
        },
        "matched_description": {
          "description": "Whether the result matched what the tool description promised",
          "type": "boolean"
        },
        "result_tokens": {
          "description": "About how many tokens the result was",
          "type": "number",
          "minimum": 0,
          "maximum": 5000000
        },
        "charged_usd": {
          "description": "What the server charged, if anything",
          "type": "number",
          "minimum": 0,
          "maximum": 1000
        },
        "surprise": {
          "description": "Anything the tool did that you did not ask for",
          "type": "string",
          "enum": [
            "side_effect",
            "unexpected_cost",
            "data_leak_suspected",
            "other"
          ]
        },
        "tools_hash": {
          "description": "The tool_list_hash of the tool list you received, if you computed it as 7Maps does",
          "type": "string",
          "maxLength": 64
        }
      },
      "required": [
        "server",
        "ok"
      ]
    }
  },
  "required": [
    "server"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Use this right before calling a tool on an MCP server you have not used today, with the exact arguments you plan to send: checks that the server answers, whether it needs sign-in, that the tool still exists under that name, and that the arguments match the tool's input schema (required, types, allowed values, unknown keys). Returns go, no_go or fix with what to change, so a failed round trip and retry are avoided. Paid per check (see list_paid_tools). Never calls the server.

{
  "type": "object",
  "properties": {
    "server": {
      "type": "string",
      "minLength": 3,
      "maxLength": 300,
      "description": "The server URL or its official registry name"
    },
    "tool": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "The tool you plan to call"
    },
    "arguments": {
      "description": "The arguments you plan to send",
      "type": "object",
      "properties": {},
      "additionalProperties": {}
    },
    "license_key": {
      "description": "A 7IT monthly plan license key, if you have one; otherwise pay per call with x402",
      "type": "string",
      "maxLength": 100
    },
    "last_trip": {
      "description": "Optional: how your last call to an MCP server went (the one 7Maps pointed you to). It keeps the map honest; accepted reports from a paying wallet earn calls at no charge.",
      "type": "object",
      "properties": {
        "server": {
          "type": "string",
          "minLength": 3,
          "maxLength": 300,
          "description": "The MCP server you called (URL or registry name)"
        },
        "tool": {
          "description": "The tool you called",
          "type": "string",
          "maxLength": 120
        },
        "ok": {
          "type": "boolean",
          "description": "Whether the call did what you needed"
        },
        "fail": {
          "description": "If it failed: unreachable, auth, args, server_error, timeout, rate_limited or wrong_result",
          "type": "string",
          "enum": [
            "unreachable",
            "auth",
            "args",
            "server_error",
            "timeout",
            "rate_limited",
            "wrong_result"
          ]
        },
        "ms": {
          "description": "How long the call took, in milliseconds",
          "type": "number",
          "minimum": 0,
          "maximum": 600000
        },
        "matched_description": {
          "description": "Whether the result matched what the tool description promised",
          "type": "boolean"
        },
        "result_tokens": {
          "description": "About how many tokens the result was",
          "type": "number",
          "minimum": 0,
          "maximum": 5000000
        },
        "charged_usd": {
          "description": "What the server charged, if anything",
          "type": "number",
          "minimum": 0,
          "maximum": 1000
        },
        "surprise": {
          "description": "Anything the tool did that you did not ask for",
          "type": "string",
          "enum": [
            "side_effect",
            "unexpected_cost",
            "data_leak_suspected",
            "other"
          ]
        },
        "tools_hash": {
          "description": "The tool_list_hash of the tool list you received, if you computed it as 7Maps does",
          "type": "string",
          "maxLength": 64
        }
      },
      "required": [
        "server",
        "ok"
      ]
    }
  },
  "required": [
    "server",
    "tool"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Use this to check that an MCP server's tools are still the ones a person approved, like a lockfile: pass the lock you saved at approval (tool name to hash, as returned by watch or tool_card) and get, per tool, unchanged, changed (with any rise in risk), removed or new. Catches rug pulls, where a tool changes after approval, which MCP clients do not re-ask about. Paid per server (see list_paid_tools). Reads the map only.

{
  "type": "object",
  "properties": {
    "server": {
      "type": "string",
      "minLength": 3,
      "maxLength": 300,
      "description": "The server URL or its official registry name"
    },
    "lock": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "string"
      },
      "description": "Tool name to hash, saved at approval"
    },
    "license_key": {
      "description": "A 7IT monthly plan license key, if you have one; otherwise pay per call with x402",
      "type": "string",
      "maxLength": 100
    },
    "last_trip": {
      "description": "Optional: how your last call to an MCP server went (the one 7Maps pointed you to). It keeps the map honest; accepted reports from a paying wallet earn calls at no charge.",
      "type": "object",
      "properties": {
        "server": {
          "type": "string",
          "minLength": 3,
          "maxLength": 300,
          "description": "The MCP server you called (URL or registry name)"
        },
        "tool": {
          "description": "The tool you called",
          "type": "string",
          "maxLength": 120
        },
        "ok": {
          "type": "boolean",
          "description": "Whether the call did what you needed"
        },
        "fail": {
          "description": "If it failed: unreachable, auth, args, server_error, timeout, rate_limited or wrong_result",
          "type": "string",
          "enum": [
            "unreachable",
            "auth",
            "args",
            "server_error",
            "timeout",
            "rate_limited",
            "wrong_result"
          ]
        },
        "ms": {
          "description": "How long the call took, in milliseconds",
          "type": "number",
          "minimum": 0,
          "maximum": 600000
        },
        "matched_description": {
          "description": "Whether the result matched what the tool description promised",
          "type": "boolean"
        },
        "result_tokens": {
          "description": "About how many tokens the result was",
          "type": "number",
          "minimum": 0,
          "maximum": 5000000
        },
        "charged_usd": {
          "description": "What the server charged, if anything",
          "type": "number",
          "minimum": 0,
          "maximum": 1000
        },
        "surprise": {
          "description": "Anything the tool did that you did not ask for",
          "type": "string",
          "enum": [
            "side_effect",
            "unexpected_cost",
            "data_leak_suspected",
            "other"
          ]
        },
        "tools_hash": {
          "description": "The tool_list_hash of the tool list you received, if you computed it as 7Maps does",
          "type": "string",
          "maxLength": 64
        }
      },
      "required": [
        "server",
        "ok"
      ]
    }
  },
  "required": [
    "server",
    "lock"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Use this to check all the MCP servers you depend on in one call instead of one by one: give up to 50 servers and the date of your last check, and get only what changed since then (outages, recoveries, tools added, removed or changed, risk increases, silent changes). Most answers are "nothing changed". Paid per call (see list_paid_tools). Reads the map only.

{
  "type": "object",
  "properties": {
    "servers": {
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 3,
        "maxLength": 300
      },
      "description": "Server URLs or official registry names"
    },
    "since": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}",
      "description": "Date of your last check (YYYY-MM-DD); up to 30 days back"
    },
    "license_key": {
      "description": "A 7IT monthly plan license key, if you have one; otherwise pay per call with x402",
      "type": "string",
      "maxLength": 100
    },
    "last_trip": {
      "description": "Optional: how your last call to an MCP server went (the one 7Maps pointed you to). It keeps the map honest; accepted reports from a paying wallet earn calls at no charge.",
      "type": "object",
      "properties": {
        "server": {
          "type": "string",
          "minLength": 3,
          "maxLength": 300,
          "description": "The MCP server you called (URL or registry name)"
        },
        "tool": {
          "description": "The tool you called",
          "type": "string",
          "maxLength": 120
        },
        "ok": {
          "type": "boolean",
          "description": "Whether the call did what you needed"
        },
        "fail": {
          "description": "If it failed: unreachable, auth, args, server_error, timeout, rate_limited or wrong_result",
          "type": "string",
          "enum": [
            "unreachable",
            "auth",
            "args",
            "server_error",
            "timeout",
            "rate_limited",
            "wrong_result"
          ]
        },
        "ms": {
          "description": "How long the call took, in milliseconds",
          "type": "number",
          "minimum": 0,
          "maximum": 600000
        },
        "matched_description": {
          "description": "Whether the result matched what the tool description promised",
          "type": "boolean"
        },
        "result_tokens": {
          "description": "About how many tokens the result was",
          "type": "number",
          "minimum": 0,
          "maximum": 5000000
        },
        "charged_usd": {
          "description": "What the server charged, if anything",
          "type": "number",
          "minimum": 0,
          "maximum": 1000
        },
        "surprise": {
          "description": "Anything the tool did that you did not ask for",
          "type": "string",
          "enum": [
            "side_effect",
            "unexpected_cost",
            "data_leak_suspected",
            "other"
          ]
        },
        "tools_hash": {
          "description": "The tool_list_hash of the tool list you received, if you computed it as 7Maps does",
          "type": "string",
          "maxLength": 64
        }
      },
      "required": [
        "server",
        "ok"
      ]
    }
  },
  "required": [
    "servers",
    "since"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}