{"openapi":"3.0.3","info":{"title":"SqueezeRank MSO — MCP Store Optimizer","version":"1.0.1","description":"Scores, audits, optimizes, and benchmarks MCP server listings for AI agent discoverability. Five paid tools settle per call in USDC on Base via x402; the pricing endpoint is free. Product: https://scriptmasterlabs.com/squeezerank-mso"},"servers":[{"url":"https://squeezeos-api.onrender.com"}],"tags":[{"name":"SqueezeRank MSO","description":"MCP listing scoring and optimization tools."}],"paths":{"/v1/mso/score":{"post":{"tags":["SqueezeRank MSO"],"operationId":"scoreListing","summary":"Score an MCP server listing across six discoverability axes","description":"Returns per-axis scores, per-tool grades A+ to F, a weighted final score from 0 to 5.0, prioritized fixes, and a public report URL. Use this to diagnose weak listing copy before optimization. Read-only unless stated otherwise. Costs $0.003 USDC per call via x402 on Base (eip155:8453). Unpaid requests return HTTP 402 with a payment challenge.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"server_name":{"type":"string","description":"Reverse-DNS server name, for example com.example/my-server."},"description":{"type":"string","description":"Current server description text."},"tools":{"type":"array","description":"Tool definitions with name, description, inputSchema, and optional annotations.","items":{"type":"object","additionalProperties":true}},"website_url":{"type":"string","format":"uri","description":"Optional website URL for contextual completeness."},"repository_url":{"type":"string","format":"uri","description":"Optional repository URL for contextual completeness."}},"required":["server_name","description"]}}}},"responses":{"200":{"description":"Successful JSON result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScoreReport"}}}},"400":{"description":"Invalid or incomplete request."},"402":{"$ref":"#/components/responses/PaymentRequired"}}}},"/v1/mso/optimize":{"post":{"tags":["SqueezeRank MSO"],"operationId":"optimizeDescription","summary":"Generate three optimized MCP server descriptions","description":"Returns three draft descriptions ranked best-first with rationale. Use this when a server description is thin, unclear, or poorly matched to registry search intent. Drafts are flagged for human review. Read-only unless stated otherwise. Costs $0.002 USDC per call via x402 on Base (eip155:8453). Unpaid requests return HTTP 402 with a payment challenge.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"server_name":{"type":"string"},"description":{"type":"string"},"keywords":{"type":"array","items":{"type":"string"}},"tools":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["server_name","description"]}}}},"responses":{"200":{"description":"Successful JSON result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OptimizeResult"}}}},"400":{"description":"Invalid or incomplete request."},"402":{"$ref":"#/components/responses/PaymentRequired"}}}},"/v1/mso/audit":{"post":{"tags":["SqueezeRank MSO"],"operationId":"auditTools","summary":"Audit MCP tool descriptions and draft targeted rewrites","description":"Grades each supplied tool and returns draft rewrites for weak descriptions using a what/returns/when/behavior pattern. Nothing is modified automatically. Read-only unless stated otherwise. Costs $0.005 USDC per call via x402 on Base (eip155:8453). Unpaid requests return HTTP 402 with a payment challenge.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"server_name":{"type":"string"},"tools":{"type":"array","items":{"type":"object","additionalProperties":true},"description":"Tool definitions to audit."}},"required":["tools"]}}}},"responses":{"200":{"description":"Successful JSON result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuditResult"}}}},"400":{"description":"Invalid or incomplete request."},"402":{"$ref":"#/components/responses/PaymentRequired"}}}},"/v1/mso/benchmark":{"post":{"tags":["SqueezeRank MSO"],"operationId":"benchmarkRegistry","summary":"Check an MCP server across public registries","description":"Probes Glama, Smithery, mcp.so, PulseMCP, and the canonical MCP Registry. Returns listed, missing, or unverifiable with observed HTTP facts; unreachable sources are not invented. Read-only unless stated otherwise. Costs $0.003 USDC per call via x402 on Base (eip155:8453). Unpaid requests return HTTP 402 with a payment challenge.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"server_name":{"type":"string","description":"Server name or registry slug to look up."}},"required":["server_name"]}}}},"responses":{"200":{"description":"Successful JSON result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BenchmarkResult"}}}},"400":{"description":"Invalid or incomplete request."},"402":{"$ref":"#/components/responses/PaymentRequired"}}}},"/v1/mso/fix-plan":{"post":{"tags":["SqueezeRank MSO"],"operationId":"generateFixPlan","summary":"Generate a prioritized optimization roadmap from a score report","description":"Builds a week-by-week plan from a prior score report, with ranked fixes, effort estimates, and expected axis impact. Read-only unless stated otherwise. Costs $0.010 USDC per call via x402 on Base (eip155:8453). Unpaid requests return HTTP 402 with a payment challenge.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"score_report":{"type":"object","additionalProperties":true,"description":"A score report returned by POST /v1/mso/score."}},"required":["score_report"]}}}},"responses":{"200":{"description":"Successful JSON result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FixPlanResult"}}}},"400":{"description":"Invalid or incomplete request."},"402":{"$ref":"#/components/responses/PaymentRequired"}}}},"/v1/mso/pricing":{"get":{"tags":["SqueezeRank MSO"],"operationId":"getMsoPricing","summary":"Get current SqueezeRank MSO pricing","description":"Free endpoint. Returns current per-tool USDC pricing, Base network information, and the $0.023 total for one call to each of the five paid optimization tools.","responses":{"200":{"description":"Current price table.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PricingResult"}}}}}}}},"components":{"schemas":{"X402PaymentRequired":{"type":"object","additionalProperties":true,"description":"x402 payment challenge response. The PAYMENT-REQUIRED response header carries the machine-readable challenge used to retry the request with payment."},"ScoreReport":{"type":"object","additionalProperties":true,"properties":{"server":{"type":"string"},"final_score":{"type":"number"},"grade":{"type":"string"},"axes":{"type":"object","additionalProperties":true},"top_fixes":{"type":"array","items":{"type":"object","additionalProperties":true}},"report_id":{"type":"string"},"report_url":{"type":"string","format":"uri"}}},"OptimizeResult":{"type":"object","additionalProperties":true,"properties":{"server_name":{"type":"string"},"candidates":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"AuditResult":{"type":"object","additionalProperties":true,"properties":{"server_name":{"type":"string"},"tool_count":{"type":"integer"},"audits":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"BenchmarkResult":{"type":"object","additionalProperties":true,"properties":{"server_name":{"type":"string"},"registries":{"type":"array","items":{"type":"object","additionalProperties":true}},"honesty":{"type":"string"}}},"FixPlanResult":{"type":"object","additionalProperties":true,"properties":{"server":{"type":"string"},"from_score":{"type":"number","nullable":true},"from_grade":{"type":"string","nullable":true},"plan":{"type":"array","items":{"type":"object","additionalProperties":true}},"note":{"type":"string"}}},"PricingResult":{"type":"object","additionalProperties":true,"properties":{"product":{"type":"string"},"version":{"type":"string"},"network":{"type":"string","example":"eip155:8453"},"asset":{"type":"string","example":"USDC"},"tools":{"type":"array","items":{"type":"object","additionalProperties":true}},"full_optimization_cycle_usdc":{"type":"string","example":"0.023"}}}},"responses":{"PaymentRequired":{"description":"Payment Required — x402 challenge. Pay the quoted USDC amount on Base and retry.","headers":{"PAYMENT-REQUIRED":{"description":"Machine-readable x402 payment challenge.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/X402PaymentRequired"}}}}}}}