{"slug": "agent-ready-engineering-is-your-mcp-server-or-api-ready-for-agents", "title": "Agent-Ready Engineering: is your MCP server or API ready for agents?", "summary": "A developer is building Agent-Ready Engineering, an open-source framework for designing and assessing business interfaces that AI agents call through MCP or an API, centered on an operation contract template (ARE-T03) that turns failure questions into checks for the service. The proposed acceptance test for a ticket system's `close_ticket` tool drops the response after a committed write, then verifies that a caller can establish the outcome and that replay with the same key produces only one change. The author is asking maintainers of MCP servers and agent-facing APIs to compare public tool schemas or operation contracts to identify changes that would make agents use them more reliably.", "body_md": "I’m building [Agent-Ready Engineering](https://github.com/tubban1/agent-ready-engineering), an open source framework for designing and assessing business interfaces that agents will call. The unit I want to assess is a business operation and the contract it exposes through MCP or an API.\n\nTake a ticket system with a tool called `close_ticket`. The tool is discoverable, its inputs have a schema, and the model knows how to call it. What happens when the caller lacks approval, the ticket has changed since it was read, or the server commits the update and the connection drops before the response arrives?\n\nThe [operation contract template](https://github.com/tubban1/agent-ready-engineering/blob/main/adoption/templates/ARE-T03-operation-contract.md) turns those questions into checks for the service:\n\nMy proposed acceptance test for the ticket interface is to drop the response after a committed write, then check that a caller can establish the outcome and that replay with the same key produces only one change. This is a test of the interface’s contract, so it can be exercised with an ordinary client.\n\nIf you maintain an MCP server or an API used by agents, which of these guarantees do you expose today? I’d like to compare one public tool schema or operation contract with another builder and see which changes would make it easier for agents to use reliably.", "url": "https://wpnews.pro/news/agent-ready-engineering-is-your-mcp-server-or-api-ready-for-agents", "canonical_source": "https://discuss.huggingface.co/t/agent-ready-engineering-is-your-mcp-server-or-api-ready-for-agents/191894#post_1", "published_at": "2026-11-15 12:34:14+00:00", "updated_at": "2026-11-15 12:52:02.244466+00:00", "lang": "en", "topics": ["ai-agents", "agent-protocols", "ai-tools", "developer-tools"], "entities": ["Agent-Ready Engineering", "MCP", "GitHub"], "also_reported_by": [], "alternates": {"html": "https://wpnews.pro/news/agent-ready-engineering-is-your-mcp-server-or-api-ready-for-agents", "markdown": "https://wpnews.pro/news/agent-ready-engineering-is-your-mcp-server-or-api-ready-for-agents.md", "text": "https://wpnews.pro/news/agent-ready-engineering-is-your-mcp-server-or-api-ready-for-agents.txt", "jsonld": "https://wpnews.pro/news/agent-ready-engineering-is-your-mcp-server-or-api-ready-for-agents.jsonld"}}