Appear retweeted
Most teams are already schema-last for their APIs -code ships, traffic flows, docs come later (if at all).
Appear just automates it. Live traffic in, accurate OpenAPI out.
Have a read here:
appear.sh/blog/schema-last-w…
#openapi #dev #APIs
You can read more about why Appear's approach to API docs for agent (and human) consumption solves the issues plaguing agents from being effective. Our MCP is where the two worlds meet: enriched & deterministic API docs, and AI agents.
appear.sh/blog/why-your-api-…
Very excited to announce that @AppearAPI has got an MCP for agents and devs to consume deterministic, realtime, and enriched APIs in your favourite agentic IDE.
This closes the loop on a key schema automation, and sees the end of manual API docs forever.
docs.appear.sh/appear-mcp/mc…
Appear has now closed the dev loop for APIs!
- Discover services from live traffic
- Document and enrich them
- Expose them via an MCP to your agentic IDE
Read about it here: docs.appear.sh/appear-mcp/mc…
Helping devs get into OpenAPI is woven through our mission to help you unleash your existing APIs in the AI age.
Our little OSS API toolkit is slowly getting better.
We're also introducing an OpenAPI + JSON schema spec hub at appear.sh to help lower & ease entry toward OAS adoption and uplift.
Preview soon!
The OpenAPI spec validator using Zod, now uses Zod4.
It also includes some improvements:
- Added $ref path validation for schema types
- Added query method for path item objects
- Changed schema object format to be string instead of enum
github.com/appear-sh/OAS-Zod…
#openapi #api
Appear solves this by automatically generating your API docs from your live traffic, while enriching them for agents.
Two pain points solved instantly:
- Out of date docs
- Docs not written for agents
#openapi #api #docs #ai
API docs are often out of date, incorrect, or just missing.
I've met CTOs who get their team to spend 3 months manually writing their docs - but now these docs need more definition for agents.
Agents demand more from your docs.
Read about it here:
appear.sh/blog/why-your-api-…
Appear retweeted
Upgrading the OAS Zod Validator to Zod v4, plus fixes and improvements:
- Adding $ref path validation to ensure it points to the component object
- Added query method to Path objects
- Changed format to support any string instead of enum
Always more to do, but it's close!
Appear retweeted
Wrote up about how Appear approaches API documentation, and why I love good docs - and so do agents and humans alike:
appear.sh/blog/end-of-manual…
Appear retweeted
This is pure gold. Agentic AI framework comparison by Ida Silfverskiöld. 10/10 for usefulness. ilsilfverskiold.com/articles…
Appear retweeted
Replying to @zebassembly
We've recently rebuilt @AppearAPI in similar way. Using @tinybasejs as sync engine to push data to Durable Objects and let users fetch them from there.
It's harder than it looks but it's 100% worth it.
Appear retweeted
literally me explaining how @AppearAPI works
Check out our open-source API Validator tool validate.appear.sh . What would you want to see in future iterations?
#openapi #validation #api #spec
We're excited to be able to provide this to the open-source community! Not long to go now!
#openapi #oas #zod #api #OpenSource
Our JS/TS introspector is now using Otel under the hood: big improvements and now able to catch inbound and outbound requests.
v1 now available: docs.appear.sh
Want instant API discovery and documentation? Get in touch now!
Great article on explaining how MCPs and APIs are symbiotic.
layered.dev/mcp-the-ultimate…
The mission is simple: enable you to make the most out of your existing APIs.
Better developer experiences, better collaboration, and (better) AI enablement.
AI for API documentation is good, but there needs to be a deterministic basis for rapid exaptation in this agentic/MCP epoch.
Appear aims to facilitate MCP & AI enablement but provides guidance on the maturation of your APIs.
#openAPI #validation #maturity #api









