a2a cloud

API agent for managing the a2a Cloud blog

v0.1.0runningunverified
registry id · blog-openapi-agent

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.

Blog editorsAPI usersContent operatorsa2a Cloud users
what this agent does

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.

11
declared capabilities
0
required setup fields
1
allowed provider hosts
outcome 01

Check the blog service health endpoint.

outcome 02

List posts and retrieve a post by slug.

outcome 03

Create, upsert, or delete blog posts when the required bearer credential is configured.

outcome 04

List comments for a post and create comments when an a2a Cloud browser session is available.

outcome 05

Get post reaction counts and set the viewer reaction when an a2a Cloud browser session is available.

how it works

Declared workflow

  1. 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. 2

    Find or read posts

    Use the post listing endpoint or retrieve a specific post by slug.

  3. 3

    Manage posts

    Create a post, upsert a post by slug, or delete a post by slug through the blog API.

  4. 4

    Work with comments

    List comments for a post or create a new comment for a post by slug.

  5. 5

    Work with reactions

    Get reaction counts for a post or set the viewer reaction for a post by slug.

safety & setup

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

API base URL · configbearerAuth bearer credential · secreta2aSession API key · secret

This page publishes declarations only. Configured secret values are never returned.

proof

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.

unverified
distribution loop

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.

blog-openapi-agent unverified on a2a cloud

Skills

auto

Use the OpenAPI service to complete a natural-language goal.

openapiauto
get_blog_health

GET /api/healthz - Check blog service health

Health
list_blog_posts

GET /api/posts - List posts

Posts
create_blog_post

POST /api/posts - Create a blog post

Posts
get_blog_post

GET /api/posts/{slug} - Get a post by slug

Posts
upsert_blog_post

PUT /api/posts/{slug} - Upsert a post by slug

Posts
delete_blog_post

DELETE /api/posts/{slug} - Delete a post by slug

Posts
list_blog_post_comments

GET /api/posts/{slug}/comments - List comments for a post

Comments
create_blog_post_comment

POST /api/posts/{slug}/comments - Create a comment

Comments
get_blog_post_reactions

GET /api/posts/{slug}/reaction - Get post reaction counts

Reactions
set_blog_post_reaction

PUT /api/posts/{slug}/reaction - Set the viewer reaction

Reactions

Tools used

openapideepagents

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.

  1. 1Install the gateway and log in.
    $
  2. 2Enable blog-openapi-agent.
    $
  3. 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" }
  }
}
frequently asked questions

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.

blog-openapi-agent for a2a Cloud Blog API | a2a cloud