{
 "openapi": "3.1.0",
 "info": {
  "title": "7Maps",
  "version": "1.0.0",
  "description": "The live map of MCP servers for AI agents (software, not geography): which server and tool to use for a task, a server’s condition before connecting, and what changed since a person approved it. Paid per call with x402.",
  "contact": {
   "url": "https://7it.co.il/7maps/"
  }
 },
 "servers": [
  {
   "url": "https://7it.co.il"
  }
 ],
 "paths": {
  "/7maps/x402/route": {
   "post": {
    "operationId": "route",
    "summary": "The safest open MCP server for a task, ranked by success chance, stability and least privilege, with alternatives.",
    "tags": [
     "7Maps"
    ],
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "task": {
          "type": "string",
          "description": "What you need to do"
         },
         "need": {
          "type": "string",
          "enum": [
           "read",
           "change",
           "high_risk"
          ]
         }
        },
        "required": [
         "task"
        ]
       },
       "example": {
        "task": "send a transactional email to a customer"
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "The answer, as JSON",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required (x402 v2, PAYMENT-REQUIRED header)"
     }
    },
    "x-payment-info": {
     "protocols": [
      "x402"
     ],
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.01"
     },
     "network": "eip155:8453",
     "asset": "USDC"
    }
   }
  },
  "/7maps/x402/road_conditions": {
   "post": {
    "operationId": "road_conditions",
    "summary": "Before connecting to an MCP server: status, sign-in, latency, tool risk levels, findings and last change, from a daily map of every remote server in the official MCP registry.",
    "tags": [
     "7Maps"
    ],
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "server": {
          "type": "string",
          "description": "Server URL, registry name, or npm:/pypi: package"
         }
        },
        "required": [
         "server"
        ]
       },
       "example": {
        "server": "https://mcp.stripe.com"
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "The answer, as JSON",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required (x402 v2, PAYMENT-REQUIRED header)"
     }
    },
    "x-payment-info": {
     "protocols": [
      "x402"
     ],
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.002"
     },
     "network": "eip155:8453",
     "asset": "USDC"
    }
   }
  },
  "/7maps/x402/watch": {
   "post": {
    "operationId": "watch",
    "summary": "Has an MCP server a person approved changed since that date, including silent risk increases and supply-chain changes.",
    "tags": [
     "7Maps"
    ],
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "server": {
          "type": "string",
          "description": "Server URL or registry name"
         },
         "approved_at": {
          "type": "string",
          "description": "YYYY-MM-DD"
         }
        },
        "required": [
         "server",
         "approved_at"
        ]
       },
       "example": {
        "server": "https://mcp.stripe.com",
        "approved_at": "2026-10-01"
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "The answer, as JSON",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required (x402 v2, PAYMENT-REQUIRED header)"
     }
    },
    "x-payment-info": {
     "protocols": [
      "x402"
     ],
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.005"
     },
     "network": "eip155:8453",
     "asset": "USDC"
    }
   }
  },
  "/7maps/x402/tool_card": {
   "post": {
    "operationId": "tool_card",
    "summary": "Compact tool cards for an MCP server instead of its full tool definitions: usually 70 to 90% fewer tokens.",
    "tags": [
     "7Maps"
    ],
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "server": {
          "type": "string",
          "description": "Server URL or registry name"
         },
         "tools": {
          "type": "array",
          "items": {
           "type": "string"
          }
         }
        },
        "required": [
         "server"
        ]
       },
       "example": {
        "server": "https://mcp.stripe.com",
        "tools": [
         "create_customer"
        ]
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "The answer, as JSON",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required (x402 v2, PAYMENT-REQUIRED header)"
     }
    },
    "x-payment-info": {
     "protocols": [
      "x402"
     ],
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.002"
     },
     "network": "eip155:8453",
     "asset": "USDC"
    }
   }
  },
  "/7maps/x402/preflight": {
   "post": {
    "operationId": "preflight",
    "summary": "Will this MCP tool call succeed: server status, sign-in, tool name and arguments checked against its schema before calling.",
    "tags": [
     "7Maps"
    ],
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "server": {
          "type": "string",
          "description": "Server URL or registry name"
         },
         "tool": {
          "type": "string",
          "description": "Tool name"
         },
         "arguments": {
          "type": "object"
         }
        },
        "required": [
         "server",
         "tool"
        ]
       },
       "example": {
        "server": "https://mcp.stripe.com",
        "tool": "create_customer",
        "arguments": {
         "email": "a@example.com"
        }
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "The answer, as JSON",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required (x402 v2, PAYMENT-REQUIRED header)"
     }
    },
    "x-payment-info": {
     "protocols": [
      "x402"
     ],
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.003"
     },
     "network": "eip155:8453",
     "asset": "USDC"
    }
   }
  },
  "/7maps/x402/verify_lock": {
   "post": {
    "operationId": "verify_lock",
    "summary": "Compare an MCP server tools with a lock saved at approval: unchanged, changed, removed or new, per tool.",
    "tags": [
     "7Maps"
    ],
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "server": {
          "type": "string",
          "description": "Server URL or registry name"
         },
         "lock": {
          "type": "object",
          "additionalProperties": {
           "type": "string"
          }
         }
        },
        "required": [
         "server",
         "lock"
        ]
       },
       "example": {
        "server": "https://mcp.stripe.com",
        "lock": {
         "create_customer": "sha256-of-its-definition"
        }
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "The answer, as JSON",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required (x402 v2, PAYMENT-REQUIRED header)"
     }
    },
    "x-payment-info": {
     "protocols": [
      "x402"
     ],
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.002"
     },
     "network": "eip155:8453",
     "asset": "USDC"
    }
   }
  },
  "/7maps/x402/changes_since": {
   "post": {
    "operationId": "changes_since",
    "summary": "What changed on up to 50 MCP servers since a date, in one call.",
    "tags": [
     "7Maps"
    ],
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "servers": {
          "type": "array",
          "items": {
           "type": "string"
          }
         },
         "since": {
          "type": "string",
          "description": "YYYY-MM-DD"
         }
        },
        "required": [
         "servers",
         "since"
        ]
       },
       "example": {
        "servers": [
         "https://mcp.stripe.com"
        ],
        "since": "2026-10-01"
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "The answer, as JSON",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required (x402 v2, PAYMENT-REQUIRED header)"
     }
    },
    "x-payment-info": {
     "protocols": [
      "x402"
     ],
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.002"
     },
     "network": "eip155:8453",
     "asset": "USDC"
    }
   }
  }
 }
}