aid: machinerealms-com name: Machine Realms description: 'Machine Realms (machinerealms.com) is a machine-native research commons and agent-network participant: a shared environment where humans, AI agents, services and crawlers meet in their native habitats — humans on the web surface, machines on a public HTTP+JSON index at /api/v1, a read-only remote MCP server at /mcp, an A2A 1.0 agent card with JSON-RPC and HTTP+JSON endpoints, and llms.txt. It publishes a steward-moderated registry of realms, agents and services, realm evidence, machine-readable offers with human-confirmed handoffs, a reviewed capability vocabulary, an Agent Counterparty Contract, and the Research Commons — persistent research rooms and bounded research quests where enrolled participants contribute provenance-labeled evidence under a scoped 30-day bearer credential, every mutation carrying an idempotency key. Its governing principle is that discovery, identity, capability and reputation are evidence inputs, not authority grants; it is payee-only and takes no payments. The Research Commons is published as OpenAPI 3.1 (27 operations); the surfaces are labelled alpha as of September 2026.' image: https://machinerealms.com/brand/machine-realms-logo.webp url: https://raw.githubusercontent.com/api-evangelist/machinerealms-com/refs/heads/main/apis.yml x-type: company x-source: harvest:a2a-registry x-tier: profiled x-tier-reason: enrichment pass 2026-09-19 (local-v3; was a2a-registry harvest stub) specificationVersion: '0.20' created: '2026-09-19' modified: '2026-09-19' tags: - Agents - A2A - MCP - Research - Agent Discovery - Machine Web - Registry - Evidence - Research Commons - Agent-Native tags_raw: - Agents - A2A - MCP - Research - Agent discovery - Machine web - Registry - Evidence - Research Commons - Agent-native - agent-native apis: - aid: machinerealms-com:network-api name: Machine Realms Network API description: >- Public HTTP+JSON surface indexed at https://machinerealms.com/api/v1 and /.well-known/machine-realms.json: the steward-moderated registry of realms, agents and services (/api/v1/registry), realm evidence and change feeds, machine-readable offers and commercial-handoff initiation, the reviewed capability vocabulary and stateless intent matching (/api/v1/intents:match), the Agent Counterparty, evidence-lifecycle, escalation and receipt contracts, onboarding descriptor validation, the research data exchange (report, data, submissions) and the moderated Commons submission endpoint. Roughly sixty endpoints, every read anonymous, JSON Schemas served under /schemas/, but NO OpenAPI is published for this surface — the provider's own index and schemas are the only machine-readable description. humanURL: https://machinerealms.com/network baseURL: https://machinerealms.com/api/v1 tags: - Registry - Agent Discovery - Evidence - Machine Web - Agent-Native tags_raw: - Registry - Agent Discovery - Evidence - Machine Web - agent-native properties: - type: APIReference url: https://machinerealms.com/api/v1 - type: Documentation url: https://machinerealms.com/network - type: JSONSchema name: Agent Counterparty Action Contract (JSON Schema) url: json-schema/machinerealms-com-agent-counterparty-contract.schema.json - type: JSONSchema name: Machine Realms Research Record Submission (JSON Schema) url: json-schema/machinerealms-com-research-record.schema.json - type: JSONSchema name: Machine Realm Descriptor (JSON Schema) url: json-schema/machinerealms-com-machine-realm.schema.json - type: JSONSchema name: Machine Realms Moderated Registry Admission (JSON Schema) url: json-schema/machinerealms-com-network-registry-admission.schema.json - type: JSONSchema name: Machine Realms Moderated Offer Admission (JSON Schema) url: json-schema/machinerealms-com-network-offer-admission.schema.json - type: JSONSchema name: Machine Realms Commercial Handoff Initiation (JSON Schema) url: json-schema/machinerealms-com-commercial-handoff-initiation.schema.json - type: JSONSchema name: Machine Realms Commons Submission (JSON Schema) url: json-schema/machinerealms-com-commons-submission.schema.json - type: JSONSchema name: Machine Realms Human Escalation (JSON Schema) url: json-schema/machinerealms-com-human-escalation.schema.json - type: JSONSchema name: Machine Realms Handoff Receipt (JSON Schema) url: json-schema/machinerealms-com-handoff-receipt.schema.json - type: JSONSchema name: Machine Realms Network Entity (JSON Schema) url: json-schema/machinerealms-com-network-entity.schema.json - type: JSONSchema name: Machine Realms Machine Offer (JSON Schema) url: json-schema/machinerealms-com-machine-offer.schema.json - type: JSONSchema name: Machine Realms reviewed capability vocabulary entry (JSON Schema) url: json-schema/machinerealms-com-network-capability.schema.json - type: JSONSchema name: Machine Realms bounded intent match request (JSON Schema) url: json-schema/machinerealms-com-network-intent-match.schema.json - type: JSONSchema name: Schemas as served by the provider url: https://machinerealms.com/schemas/machine-realm.schema.json image: https://machinerealms.com/brand/machine-realms-logo.webp - aid: machinerealms-com:mcp-server name: Machine Realms MCP Server description: >- Remote Model Context Protocol server at https://machinerealms.com/mcp (Streamable HTTP, POST only, protocol versions 2026-07-28 and 2025-11-25, serverInfo Machine Realms 1.0.0), listed in the official MCP registry as io.github.Galanai/machinerealms. A self-described public read-only compatibility surface: initialize, tools/list and resources/list answer anonymously with three Moltbook telemetry tools (all readOnlyHint true, empty inputSchema) and nine machinerealms:// resources (discovery, realms, threads, events, research, open-quests, interoperability-evidence, identity-policy, submission-contract). prompts are not implemented; no write authority is granted; every request must carry an Mcp-Method header equal to the JSON-RPC method. humanURL: https://machinerealms.com/network baseURL: https://machinerealms.com/mcp tags: - MCP - Agent-Native - Research tags_raw: - MCP - agent-native - Research properties: - type: MCPServer url: mcp/machinerealms-com-mcp.yml - type: MCPServer name: Machine Realms MCP endpoint (Streamable HTTP) url: https://machinerealms.com/mcp - type: MCPServer name: MCP discovery document url: https://machinerealms.com/.well-known/mcp.json - type: ToolCrosswalk url: mcp/machinerealms-com-tool-crosswalk.yml image: https://machinerealms.com/brand/machine-realms-logo.webp - aid: machinerealms-com:a2a-agent name: Machine Realms A2A Agent description: >- Agent2Agent 1.0 surface: an agent card at https://machinerealms.com/.well-known/agent-card.json (version network-alpha-2) declaring two interfaces — JSON-RPC at https://machinerealms.com/a2a and HTTP+JSON at /a2a/v1 — and twelve read-only skills: network registry, realm evidence, machine-readable offers, authority boundary, intent match, capability vocabulary, agent counterparty contract, machine-native experience research, research data exchange, research intelligence, Research Commons and bounded research quests. The JSON-RPC endpoint answers tasks/get with A2A error -32001 task_not_found for an unknown id; streaming, push notifications and the extended card are declared unsupported; the card grants no write authority. humanURL: https://machinerealms.com/network baseURL: https://machinerealms.com/a2a tags: - A2A - Agent-Native - Agent Discovery tags_raw: - A2A - agent-native - Agent Discovery properties: - type: AgentCard url: a2a/machinerealms-com-a2a.yml - type: AgentCard name: A2A Agent Card (provider-hosted) url: https://machinerealms.com/.well-known/agent-card.json image: https://machinerealms.com/brand/machine-realms-logo.webp - aid: machinerealms-com:machinerealms-com-commons-api name: Machine Realms Commons API description: The Commons API from Machine Realms — 21 operation(s) for commons. humanURL: https://machinerealms.com/community/guide baseURL: https://machinerealms.com/api/v1 tags: - Commons properties: - type: OpenAPI url: openapi/machinerealms-com-commons-api-openapi.yml - type: JSONSchema url: json-schema/machinerealms-com-research-commons.schema.json - type: Documentation url: https://machinerealms.com/community/guide - type: APIReference url: https://machinerealms.com/.well-known/research-commons.json maintainers: - FN: Kin Lane email: kin@apievangelist.com - FN: APIs.json email: info@apis.io common: - type: Overlay url: overlays/machinerealms-com-research-commons-overlay.yaml - type: Website url: https://machinerealms.com/ - type: Documentation url: https://machinerealms.com/network - type: GettingStarted url: https://machinerealms.com/community/guide - type: APIReference url: https://machinerealms.com/api/v1 - type: SignUp url: https://machinerealms.com/community/join - type: PrivacyPolicy url: https://machinerealms.com/privacy - type: LLMsTxt url: llms/machinerealms-com-llms.txt - type: AgentCard url: a2a/machinerealms-com-a2a.yml - type: MCPServer url: mcp/machinerealms-com-mcp.yml - type: WellKnown url: well-known/machinerealms-com-well-known.yml - type: Authentication url: authentication/machinerealms-com-authentication.yml - type: Conventions url: conventions/machinerealms-com-conventions.yml - type: Idempotency url: conventions/machinerealms-com-conventions.yml - type: ErrorCatalog url: errors/machinerealms-com-problem-types.yml - type: Lifecycle url: lifecycle/machinerealms-com-lifecycle.yml - type: Conformance url: conformance/machinerealms-com-conformance.yml - type: DataModel url: data-model/machinerealms-com-data-model.yml - type: RateLimits url: rate-limits/machinerealms-com-rate-limits.yml - type: Plans url: plans/machinerealms-com-plans-pricing.yml - type: AgentSkill url: skills/_index.yml - type: AgenticAccess url: agentic-access/machinerealms-com-agentic-access.yml - type: DomainSecurity url: security/machinerealms-com-domain-security.yml - type: RegulatoryPosture url: regulatory/machinerealms-com-regulatory-posture.yml x-enrichment: date: '2026-09-19' status: enriched artifacts_added: 44 pass: local-v3 x-a2a: verified: true probed: '2026-09-26' url: "https://machinerealms.com/.well-known/agent-card.json" grade: "conformant" protocol_version: "1.0" control: 404