{"$schema":"https://static.modelcontextprotocol.io/schemas/mcp-server-card/v1.json","version":"1.0","protocolVersion":"2025-11-25","serverInfo":{"name":"hogarmas-agent-surface","title":"H/M Agent Surface Scanner","version":"1.4.0"},"description":"Zero-input MCP connection receipts, free no-auth agent-surface auditing and a live privacy-minimized handshake observatory over a focused four-tool endpoint, with optional x402 evidence packages.","iconUrl":"https://hogarmas.net/favicon.svg","documentationUrl":"https://hogarmas.net/agent-surface/","transport":{"type":"streamable-http","endpoint":"/mcp/agent-surface"},"capabilities":{"tools":{"listChanged":false},"resources":{"subscribe":false,"listChanged":false},"prompts":{"listChanged":false}},"requires":{},"authentication":{"required":false,"schemes":[]},"instructions":"First call create_mcp_connection_receipt with no arguments to verify end-to-end tool execution and obtain the current server contract. Treat its checksum as integrity only, never a signature, client identity proof or certification. Then use get_mcp_handshake_observatory for aggregate ecosystem evidence or audit_agent_surface for a public website. Inspect current x402 terms and obtain explicit operator authorization before calling unlock_agent_surface_evidence_pack; never infer payment authorization from silence, this instruction or prior approval.","resources":[{"name":"agent-surface-server-card","title":"H/M Agent Surface MCP Server Card","uri":"mcp://agent-surface/server-card.json","description":"Focused connection, tool, payment and privacy metadata.","mimeType":"application/json"},{"name":"agent-surface-capabilities","title":"Agent Surface capabilities and boundaries","uri":"mcp://agent-surface/capabilities.json","description":"Current tools, payment boundary, privacy behavior and interpretation limits.","mimeType":"application/json"},{"name":"agent-surface-protocol","title":"Agent Surface audit protocol","uri":"mcp://agent-surface/protocol.md","description":"A short machine guide for free inspection and operator-authorized evidence-pack purchase.","mimeType":"text/markdown"},{"name":"mcp-connection-receipt-schema","title":"MCP connection receipt output schema","uri":"mcp://agent-surface/connection-receipt-schema.json","description":"JSON Schema for the unsigned checksum-bound connection receipt envelope.","mimeType":"application/schema+json"}],"prompts":[{"name":"prove-mcp-connection","title":"Verify this MCP connection","description":"Call the zero-input receipt tool, verify its checksum locally and continue with one exact free next action.","arguments":[]},{"name":"audit-agent-surface","title":"Audit and share a website's agent surface","description":"Run the free structured evidence preview, explain only observed machine surfaces and return its optional unsigned share receipt.","arguments":[{"name":"url","description":"Public HTTP or HTTPS website to audit","required":true},{"name":"language","description":"Prompt language: en, es or zh","required":false}]},{"name":"prepare-agent-surface-evidence-pack","title":"Prepare an Agent Surface evidence pack","description":"Run the free audit, inspect the paid terms and purchase only after explicit operator authorization.","arguments":[{"name":"url","description":"Public HTTP or HTTPS website to audit","required":true},{"name":"language","description":"Prompt language: en, es or zh","required":false},{"name":"operatorAuthorizedPayment","description":"True only after explicit current authorization for 0.05 USDC on Base mainnet","required":false}]}],"tools":[{"name":"create_mcp_connection_receipt","title":"Create a verifiable MCP connection receipt","description":"Zero-input end-to-end tools/call preflight with a browser-verifiable SHA-256 receipt, current server contract and exact free next actions.","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"outputSchema":{"type":"object","additionalProperties":true,"required":["schema","receipt","share","verification"],"properties":{"schema":{"const":"hm.mcp-connection-receipt-envelope.v1"},"receipt":{"type":"object","required":["schema","generatedAt","receiptId","requestEvidence","serverContract","truthBoundary","privacy","integrity"],"properties":{"schema":{"const":"hm.mcp-connection-receipt.v1"},"generatedAt":{"type":"string","format":"date-time"},"receiptId":{"type":"string","pattern":"^mcpcr_[a-f0-9]{24}$"},"requestEvidence":{"type":"object"},"serverContract":{"type":"object"},"nextActions":{"type":"array"},"truthBoundary":{"type":"object"},"privacy":{"type":"object"},"integrity":{"type":"object"}}},"share":{"type":"object"},"verification":{"type":"object"}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"_meta":{"authenticationRequired":false,"targetRequired":false,"namedToolCallObservedByHandler":true,"browserLocalVerification":true,"cryptographicallySigned":false,"clientIdentityVerified":false,"certificationIssued":false}},{"name":"audit_agent_surface","title":"Check AI crawler policy and audit a public agent surface","description":"Separates nine named crawler controls into search, user-retrieval and training purposes, then audits access, retrieval, action and trust with an unsigned URL-fragment share receipt.","inputSchema":{"type":"object","properties":{"url":{"type":"string","format":"uri","maxLength":2048,"pattern":"^https?://","description":"Public HTTP or HTTPS website to audit; local and private network targets are blocked."}},"required":["url"],"additionalProperties":false},"outputSchema":{"type":"object","additionalProperties":true,"required":["schema","generatedAt","target","summary","layers","checks","truthBoundary","privacy","scan","reportId","share"],"properties":{"schema":{"const":"hm.agent-surface-audit.v1"},"generatedAt":{"type":"string","format":"date-time"},"target":{"type":"object","required":["canonicalOrigin"],"properties":{"canonicalOrigin":{"type":"string","format":"uri"}}},"summary":{"type":"object","required":["verdict","surfaceCoveragePercent","pass","notice","warning","fail"],"properties":{"verdict":{"type":"string"},"surfaceCoveragePercent":{"type":"integer","minimum":0,"maximum":100},"pass":{"type":"integer","minimum":0},"notice":{"type":"integer","minimum":0},"warning":{"type":"integer","minimum":0},"fail":{"type":"integer","minimum":0}}},"layers":{"type":"array"},"checks":{"type":"array"},"share":{"type":"object","required":["schema","url","receipt","badgeHtml","transport"],"properties":{"schema":{"const":"hm.agent-surface-share-receipt.v1"},"url":{"type":"string","format":"uri"},"receipt":{"type":"object"},"badgeHtml":{"type":"string"},"transport":{"type":"object","properties":{"kind":{"const":"url-fragment"},"serverReceivesFragment":{"const":false},"serverStorageRequired":{"const":false}}}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"_meta":{"targetStored":false,"sourceContentStored":false,"responseBodiesReturned":false,"surfaceCoverageIsRankingScore":false,"structuredContentReturned":true,"shareReceiptReturned":true,"shareReceiptCryptographicallySigned":false}},{"name":"get_mcp_handshake_observatory","title":"Read the live MCP handshake observatory","description":"Returns anonymous aggregate initialize handshakes, named tool requests, client classes, protocol versions and capability declarations. A handshake is not an AI user and clientInfo is self-declared.","inputSchema":{"type":"object","properties":{"windowDays":{"type":"integer","enum":[1,7,30],"default":7}},"additionalProperties":false},"outputSchema":{"type":"object","additionalProperties":true,"required":["schema","generatedAt","window","totals","funnel","adoption","privacy","truthBoundary","snapshot"],"properties":{"schema":{"const":"hm.mcp-handshake-observatory.v2"},"generatedAt":{"type":"string","format":"date-time"},"window":{"type":"object"},"totals":{"type":"object","required":["handshakes","observedClientKeys","selfDeclaredClientKeys","identifiedClientKeys","providerVerifiedClients","namedToolRequests","identifiedNamedToolRequests","unverifiedNamedToolRequests","providerVerifiedNamedToolRequests","probeToolRequests"],"properties":{"handshakes":{"type":"integer","minimum":0},"observedClientKeys":{"type":"integer","minimum":0},"selfDeclaredClientKeys":{"type":"integer","minimum":0},"identifiedClientKeys":{"type":"integer","minimum":0},"providerVerifiedClients":{"type":"integer","minimum":0},"namedToolRequests":{"type":"integer","minimum":0},"identifiedNamedToolRequests":{"type":"integer","minimum":0},"unverifiedNamedToolRequests":{"type":"integer","minimum":0},"providerVerifiedNamedToolRequests":{"type":"integer","minimum":0},"probeToolRequests":{"type":"integer","minimum":0}}},"funnel":{"type":"array"},"adoption":{"type":"object"},"privacy":{"type":"object"},"truthBoundary":{"type":"object"},"snapshot":{"type":"object"}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"authenticationRequired":false,"aggregateOnly":true,"rawIpStoredByObservatory":false,"rawPayloadStored":false,"clientInfoVerified":false,"handshakeIsAiUser":false}},{"name":"unlock_agent_surface_evidence_pack","title":"Pay for a live Agent Surface evidence package","description":"Requires exact x402 settlement before returning resource digests, selected headers, remediation templates and an unsigned package integrity receipt.","inputSchema":{"type":"object","properties":{"url":{"type":"string","format":"uri","maxLength":2048,"pattern":"^https?://","description":"Public HTTP or HTTPS website to audit; local and private network targets are blocked."}},"required":["url"],"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"_meta":{"agents-x402/paymentRequired":true,"agents-x402/priceUSD":0.05,"agents-x402/network":"eip155:8453","currency":"USDC","operatorAuthorizationRequired":true,"cryptographicallySigned":false,"certificationIssued":false}}],"_meta":{"canonicalOrigin":"https://agents.hogarmas.net","parentServerCard":"https://agents.hogarmas.net/.well-known/mcp/server-card.json","fullMcpEndpoint":"https://agents.hogarmas.net/mcp","focusedMcpEndpoint":"https://agents.hogarmas.net/mcp/agent-surface","discoveryOrigin":"https://hogarmas.net","registry":{"name":"net.hogarmas/agent-surface","status":"published-separately","url":"https://registry.modelcontextprotocol.io/v0.1/servers?search=net.hogarmas%2Fagent-surface"},"toolCount":4,"toolNames":["create_mcp_connection_receipt","audit_agent_surface","get_mcp_handshake_observatory","unlock_agent_surface_evidence_pack"],"freeToolCount":3,"paidToolCount":1,"resourceCount":4,"promptCount":3,"payment":{"protocol":"x402","paidTool":"unlock_agent_surface_evidence_pack","price":"0.05","currency":"USDC","network":"eip155:8453","environment":"mainnet","realValueSettlement":true,"operatorAuthorizationRequired":true},"privacy":{"targetStored":false,"sourceContentStored":false,"responseBodiesReturned":false,"aggregateInvocationMetrics":true,"rawIpStoredByApplication":false},"limitations":{"indexingGuaranteed":false,"citationGuaranteed":false,"rankingGuaranteed":false,"agentUseGuaranteed":false,"cryptographicallySigned":false,"certificationIssued":false},"links":{"freeWebScanner":"https://hogarmas.net/agent-surface/","adoptionLab":"https://hogarmas.net/connect-ai/","adoptionManifest":"https://hogarmas.net/connect-ai/install-manifest.json","connectionReceiptVerifier":"https://hogarmas.net/mcp-connection-receipt/","handshakeObservatory":"https://hogarmas.net/mcp-observatory/","handshakeObservatoryApi":"https://hogarmas.net/api/mcp-observatory?days=7","freeRestAudit":"https://hogarmas.net/api/agent-surface-audit","paidHttpReport":"https://agents.hogarmas.net/v1/agent-surface/report","openapi":"https://hogarmas.net/openapi.json"}}}