← worcflow.ai

A2A Protocol

Agent-to-Agent Discovery

worcflow.ai implements the A2A (Agent-to-Agent) protocol for autonomous agent discovery. Your agent can find us, understand our capabilities, and integrate — without a human in the loop.

Discovery Endpoints

worcflow.ai publishes four machine-readable discovery files that agents can use to find and evaluate our service.

Agent Card

JSON

A2A protocol agent discovery card with skills, auth schemes, and capabilities.

/.well-known/agent-card.json

agents.json

JSON

Agent workflow specifications with step-by-step integration flows.

/.well-known/agents.json

llms.txt

Markdown

Human-and-LLM-readable overview of capabilities and API endpoints.

/llms.txt

OpenAPI Spec

JSON

Complete machine-readable REST API specification.

/api/v1/openapi.json

Agent Card

The Agent Card at /.well-known/agent-card.json declares our identity, capabilities, authentication, and skills.

/.well-known/agent-card.json
{
  "name": "worcflow.ai",
  "description": "Commitment tracking service for WhatsApp and email conversations.",
  "url": "https://api.worcflow.ai/a2a",
  "version": "1.0.0",
  "provider": {
    "organization": "worcflow.ai",
    "url": "https://worcflow.ai"
  },
  "capabilities": {
    "streaming": false,
    "pushNotifications": true
  },
  "authentication": {
    "schemes": ["Bearer", "OAuth2"]
  },
  "skills": [
    { "id": "query_commitments", ... },
    { "id": "get_at_risk", ... },
    { "id": "send_nudge", ... },
    { "id": "list_workspaces", ... }
  ]
}

Declared Skills

query_commitmentsQuery Commitments

Retrieve and filter tracked commitments by status, owner, client, date range, or confidence threshold. Primary agent endpoint.

Input: application/jsonOutput: application/json
get_at_riskGet At-Risk Commitments

Retrieve commitments approaching their deadline without completion confirmation. Sorted by urgency.

Input: application/jsonOutput: application/json
send_nudgeSend Nudge

Send a reminder to the commitment owner via WhatsApp or email. Includes commitment details and deadline.

Input: application/jsonOutput: application/json
list_workspacesList Workspaces

List workspaces the authenticated agent has access to, including channel configuration and commitment counts.

Input: application/jsonOutput: application/json

Agent Workflows

The agents.json file defines two pre-built workflows that agents can follow.

Query commitments from authorized channels

Connect to an existing workspace (set up by a human) and consume structured commitment data extracted from WhatsApp groups and email threads.

1
listWorkspaces

List workspaces the agent has access to

2
queryCommitments

Retrieve and filter extracted commitments

3
getAtRiskCommitments

Identify commitments approaching deadline

Monitor and nudge at-risk commitments

Check for commitments approaching deadline and send reminders to owners.

1
getAtRiskCommitments

Get commitments that are at risk of being missed

2
sendNudge

Send reminder to commitment owner

Agent Integration Flow

How an agent discovers and integrates with worcflow.ai:

agent discovery flow
# 1. Discover — read the agent card
curl https://worcflow.ai/.well-known/agent-card.json

# 2. Evaluate — understand capabilities and auth
curl https://worcflow.ai/.well-known/agents.json

# 3. Connect — authenticate with API key
curl https://api.worcflow.ai/v1/commitments \
  -H "Authorization: Bearer agent_sk_..."

# 4. Act — query commitments and send nudges
curl https://api.worcflow.ai/v1/commitments?status=at_risk
curl -X POST https://api.worcflow.ai/v1/nudges \
  -H "Authorization: Bearer agent_sk_..." \
  -d '{"commitment_id": "cmt_a1b2c3"}'

Authentication

worcflow.ai supports two authentication schemes for agent integration:

Bearer Token

Simple API key authentication for direct integrations.

Authorization: Bearer agent_sk_...

OAuth 2.1 Client Credentials

For agent-to-agent flows with scoped permissions.

messages:write commitments:read nudges:write
← MCP ServerAPI Reference →