⚑ Machine & Agent Protocol

Coddiv API & Agent Discovery

Machine-readable specifications, OpenAPI definitions, and agentic resource discovery catalogs for automated integration with Coddiv software engineering systems.

RFC 9727 application/linkset+json

API Catalog

Standardized directory of machine-readable APIs, OpenAPI schemas, and status endpoints.

/.well-known/api-catalog β†’
ARD Spec application/json

Agentic Resource Discovery (ARD)

Capability manifest exposing MCP servers, API tools, and semantic query targets.

/.well-known/ai-catalog.json β†’
SEP-1649 MCP Protocol

MCP Server Card

Model Context Protocol card declaring available server tools, prompts, and streaming endpoints.

/.well-known/mcp/server-card.json β†’
OpenAPI 3.1 & MPP Machine Payments

OpenAPI Specification

Complete contract for public endpoints including Machine Payment Protocol (MPP) payment metadata.

/openapi.json β†’
RFC 9728 & Auth.md Authentication

Agent Auth & Registration

OAuth 2.0 / OIDC metadata, Protected Resource Metadata, and agent registration specifications.

/auth.md /.well-known/oauth-protected-resource /.well-known/oauth-authorization-server
Poppy v0.1 Agent Discovery

Personal Agent Protocol

Public discovery and domain issuer binding for autonomous personal agents.

/.well-known/poppy.json β†’

HTTP Headers & Content Negotiation

RFC 8288 Link Headers: Every public page response from Coddiv includes standard Link headers advertising the API catalog, documentation, and ARD capabilities.

Link: <https://coddiv.com/.well-known/api-catalog>; rel="api-catalog", <https://coddiv.com/docs/api>; rel="service-doc", <https://coddiv.com/openapi.json>; rel="service-desc", <https://coddiv.com/.well-known/ai-catalog.json>; rel="describedby"

Markdown Content Negotiation: Agents can request markdown by sending: Accept: text/markdown. The server returns clean structured markdown with an x-markdown-tokens header.