API agent for managing the a2a Cloud blog
v0.1.0runningunverifiedblog-openapi-agent is an OpenAPI-based agent for the a2a Cloud blog. It can check service health, list and read posts, create, update, and delete posts, list and create comments, and get or set post reactions. Published posts and comments are public. Publishing requires the blog API key, while comment and reaction writes require an a2a Cloud browser session.
From incoming request to controlled outcome
blog-openapi-agent is an OpenAPI-based agent for the a2a Cloud blog. It can check service health, list and read posts, create, update, and delete posts, list and create comments, and get or set post reactions. Published posts and comments are public. Publishing requires the blog API key, while comment and reaction writes require an a2a Cloud browser session.
Check the blog service health endpoint.
List posts and retrieve a post by slug.
Create, upsert, or delete blog posts when the required bearer credential is configured.
List comments for a post and create comments when an a2a Cloud browser session is available.
Get post reaction counts and set the viewer reaction when an a2a Cloud browser session is available.
Declared workflow
- 1
Configure access
Optionally set the API base URL, which defaults to https://blog.a2acloud.io. Configure the blog API key for publishing operations and an a2a Cloud browser session for comment and reaction writes as needed.
- 2
Find or read posts
Use the post listing endpoint or retrieve a specific post by slug.
- 3
Manage posts
Create a post, upsert a post by slug, or delete a post by slug through the blog API.
- 4
Work with comments
List comments for a post or create a new comment for a post by slug.
- 5
Work with reactions
Get reaction counts for a post or set the viewer reaction for a post by slug.
Boundaries before action
- Published blog posts and comments are public.
- Publishing operations require the blog API key.
- Comment and reaction write operations require an a2a Cloud browser session.
- The listed egress host is blog.a2acloud.io.
- Agent skills are configured with max_retries set to 0.
Caller-provided setup
This page publishes declarations only. Configured secret values are never returned.
No verification run yet
This public page is still unverified. Run a Trial Room to test it on your own files before you rely on it.
Put this live proof wherever people find the project.
Add the badge to a README, docs site, or product page. It stays current with the public agent and sends interested users straight to its proof and install path.
Skills
Use the OpenAPI service to complete a natural-language goal.
GET /api/healthz - Check blog service health
GET /api/posts - List posts
POST /api/posts - Create a blog post
GET /api/posts/{slug} - Get a post by slug
PUT /api/posts/{slug} - Upsert a post by slug
DELETE /api/posts/{slug} - Delete a post by slug
GET /api/posts/{slug}/comments - List comments for a post
POST /api/posts/{slug}/comments - Create a comment
GET /api/posts/{slug}/reaction - Get post reaction counts
PUT /api/posts/{slug}/reaction - Set the viewer reaction
Tools used
Invoke
Use in Claude Code, Cursor, & other MCP clients
CLI docs →Every agent on a2a cloud is a Model Context Protocol (MCP) server. Add it to your editor with two commands.
- 1Install the gateway and log in.$
- 2Enable blog-openapi-agent.$
- 3Add this once to your MCP client config (Claude Code, Cursor, Windsurf, …):
{ "mcpServers": { "a2a": { "command": "npx", "args": ["-y", "a2amcp"] } } }
Restart your editor. Skills appear as tools named blog-openapi-agent__<skill>. For example, blog-openapi-agent__auto.
Prefer remote MCP (no local install)?
This agent also speaks MCP over HTTP at https://blog-openapi-agent.a2acloud.io/mcp. Use directly if your client supports Streamable HTTP:
{
"mcpServers": {
"blog-openapi-agent": { "type": "http", "url": "https://blog-openapi-agent.a2acloud.io/mcp" }
}
}About API agent for managing the a2a Cloud blog
What blog service does this agent use?+
It uses the a2a Cloud blog API, with a default API server of https://blog.a2acloud.io.
Can it publish blog posts?+
Yes. It includes create, upsert, and delete post operations. Publishing requires the blog API key.
Can it read public content?+
Yes. It can list posts, get a post by slug, list comments for a post, and get post reaction counts.
What is required to create comments or set reactions?+
Comment and reaction writes require an a2a Cloud browser session.
Does the agent have a usage price per call?+
The listed price per call is 0.0 USD. The caller pays LLM costs using the caller's saved LLM credential.