{"openapi":"3.1.0","info":{"title":"CommissionSalesJobs.com — Machine Interfaces","version":"1.1.0","description":"Public machine-readable surfaces: MCP JSON-RPC job marketplace tools, feeds, discovery documents, and operational health. Human-only actions (apply, post) are NOT exposed as APIs.","contact":{"name":"CommissionSalesJobs.com","email":"hiring@fibersalesjobs.com","url":"http://localhost:3000"},"license":{"name":"Data usable with attribution + link; see /.well-known/agent policies"}},"servers":[{"url":"http://localhost:3000"}],"paths":{"/mcp":{"get":{"operationId":"getMcpManifest","summary":"MCP server manifest (public discovery)","tags":["MCP"],"responses":{"200":{"description":"Server + tool manifest with authentication requirements"}}},"post":{"operationId":"mcpJsonRpc","summary":"MCP JSON-RPC 2.0 (initialize | tools/list | tools/call | ping)","tags":["MCP"],"security":[{"webmcpBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["jsonrpc","id","method"],"properties":{"jsonrpc":{"type":"string","const":"2.0"},"id":{"oneOf":[{"type":"string"},{"type":"number"}]},"method":{"type":"string","enum":["initialize","tools/list","tools/call","ping"]},"params":{"type":"object"}}},"example":{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_stats","arguments":{}}}}}},"responses":{"200":{"description":"JSON-RPC result"},"400":{"description":"Malformed JSON-RPC"},"401":{"description":"WebMCP authentication required/invalid (when server tokens are configured)"},"426":{"description":"Client must send initialize first"}}}},"/feed.xml":{"get":{"operationId":"getRssFeed","summary":"RSS 2.0 feed of open listings","tags":["Feeds"],"responses":{"200":{"description":"application/rss+xml"}}}},"/feed.json":{"get":{"operationId":"getJsonFeed","summary":"JSON Feed 1.1 of open listings","tags":["Feeds"],"responses":{"200":{"description":"application/feed+json"}}}},"/changelog.json":{"get":{"operationId":"getChangelog","summary":"Release feed (Keep a Changelog 1.1)","tags":["Feeds"],"responses":{"200":{"description":"Changelog object"}}}},"/schemas/job/v1.json":{"get":{"operationId":"getJobSchemaV1","summary":"JSON Schema 2020-12 of the public job object","tags":["Schemas"],"responses":{"200":{"description":"application/schema+json"}}}},"/developers":{"get":{"operationId":"getDevelopersHub","summary":"Human-readable integration guide","tags":["Discovery"],"responses":{"200":{"description":"text/html"}}}},"/sitemap.xml":{"get":{"operationId":"getSitemap","summary":"Canonical URL sitemap (live inventory)","tags":["Discovery"],"responses":{"200":{"description":"application/xml"}}}},"/version.json":{"get":{"operationId":"getVersion","summary":"Deployment version metadata","tags":["Operations"],"responses":{"200":{"description":"Version object"}}}},"/health":{"get":{"operationId":"getHealth","summary":"Liveness probe (minimal)","tags":["Operations"],"responses":{"200":{"description":"{ ok: true }"}}}},"/ready":{"get":{"operationId":"getReadiness","summary":"Readiness probe (data layer status word only)","tags":["Operations"],"responses":{"200":{"description":"Readiness object"}}}},"/.well-known/vectrx":{"get":{"operationId":"getDomainCapabilities","summary":"Domain capability manifest","tags":["Discovery"],"responses":{"200":{"description":"Capability object"}}}},"/.well-known/agent":{"get":{"operationId":"getAgentCard","summary":"Agent card: capabilities, policies, endpoints","tags":["Discovery"],"responses":{"200":{"description":"Agent card"}}}},"/.well-known/mcp":{"get":{"operationId":"getMcpDiscovery","summary":"MCP endpoint discovery document","tags":["Discovery"],"responses":{"200":{"description":"MCP discovery"}}}},"/.well-known/security.txt":{"get":{"operationId":"getSecurityTxt","summary":"Vulnerability disclosure policy (RFC 9116)","tags":["Trust"],"responses":{"200":{"description":"text/plain"}}}},"/llms.txt":{"get":{"operationId":"getLlmsTxt","summary":"AI ground-truth index","tags":["Discovery"],"responses":{"200":{"description":"text/plain"}}}},"/llms-full.txt":{"get":{"operationId":"getLlmsFullTxt","summary":"Extended AI reference document","tags":["Discovery"],"responses":{"200":{"description":"text/plain"}}}}},"components":{"securitySchemes":{"webmcpBearer":{"type":"http","scheme":"bearer","description":"WebMCP origin-bound token. Required on /mcp POST only when the server has WEBMCP_TOKEN configured (see GET /mcp manifest)."}},"schemas":{"JobListing":{"$ref":"http://localhost:3000/schemas/job/v1.json"}}}}