Agentifizierung A2a API

The A2a API from Agentifizierung — 3 operation(s) for a2a.

Operations 4

GET /a2a/v1 Service-Index des A2A-Endpunkts #
POST /a2a/v1 Anfrage per JSON-RPC 2.0 senden #
GET /a2a/v1/skills Skills, abgedeckte Prozesse und Systeme #
POST /a2a/v1/message:send Anfrage einordnen und an Menschen übergeben #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/agentifizierung-de:agentifizierung-de-a2a-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

agentifizierung-de-a2a-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Agentifizierung De A2a API
  version: 1.0.0
  contact:
    name: Agentifizierung
    email: info@agentifizierung.de
    url: https://www.agentifizierung.de/developers
  license:
    name: Proprietary
    url: https://www.agentifizierung.de/impressum
  description: 'Operations tagged A2a across 2 of this provider''s published API definitions: agentifizierung-de-openapi.json, agentifizierung-de.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://www.agentifizierung.de
security: []
tags:
- name: A2a
paths:
  /a2a/v1:
    get:
      summary: Service-Index des A2A-Endpunkts
      operationId: getA2AServiceIndex
      description: Beschreibt die verfügbaren Operationen, die Agent Card und die menschlichen Kontaktwege. Guter erster Aufruf, um zu prüfen, ob der Endpunkt zur Aufgabe passt.
      responses:
        '200':
          description: Service-Index
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceIndex'
        '405':
          $ref: '#/components/responses/Error'
      tags:
      - A2a
    post:
      summary: Anfrage per JSON-RPC 2.0 senden
      operationId: sendA2ARpcMessage
      description: Nimmt eine JSON-RPC-2.0-Anfrage mit der Methode "message/send" entgegen. Ohne jsonrpc-Feld wird der Rumpf wie bei message:send behandelt.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/JsonRpcRequest'
      responses:
        '200':
          description: JSON-RPC-Antwort mit einer A2A-Message als Ergebnis
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonRpcResponse'
        '400':
          $ref: '#/components/responses/Error'
      tags:
      - A2a
    servers:
    - url: https://www.agentifizierung.de
  /a2a/v1/skills:
    get:
      summary: Skills, abgedeckte Prozesse und Systeme
      operationId: getA2ASkills
      description: Listet die Skills des Endpunkts, die abgedeckten Prozesse und Systeme, die Abgrenzung und die Angaben, die eine Anfrage brauchbar machen. Ohne POST prüfbar.
      responses:
        '200':
          description: Skills und abgedeckte Bereiche
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Skills'
        '405':
          $ref: '#/components/responses/Error'
      tags:
      - A2a
    servers:
    - url: https://www.agentifizierung.de
  /a2a/v1/message:send:
    post:
      summary: Anfrage einordnen und an Menschen übergeben
      operationId: sendA2AMessage
      description: 'Ordnet eine Anfrage ein: erkennt Prozess, Systeme, Volumen, Datenzugang und Entscheider, bewertet die Passung, benennt fehlende Angaben und gibt die Kontaktwege zurück. Umgesetzt wird anschließend von Menschen.'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SendMessageRequest'
            example:
              message:
                role: user
                kind: message
                messageId: m1
                parts:
                - kind: text
                  text: Wir bekommen 4000 Serviceanfragen im Monat in Zendesk und wollen die Erstqualifizierung automatisieren. API-Zugang ist vorhanden.
      responses:
        '200':
          description: A2A-Message mit Text- und Datenteil
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentMessage'
        '400':
          $ref: '#/components/responses/Error'
        '405':
          $ref: '#/components/responses/Error'
      tags:
      - A2a
    servers:
    - url: https://www.agentifizierung.de
components:
  schemas:
    JsonRpcRequest:
      type: object
      properties:
        jsonrpc:
          type: string
          enum:
          - '2.0'
        id:
          oneOf:
          - type: string
          - type: number
        method:
          type: string
          enum:
          - message/send
        params:
          $ref: '#/components/schemas/SendMessageRequest'
      required:
      - jsonrpc
      - method
      - params
    UserMessage:
      type: object
      properties:
        role:
          type: string
          enum:
          - user
        kind:
          type: string
          enum:
          - message
        messageId:
          type: string
        contextId:
          type: string
        parts:
          type: array
          minItems: 1
          items:
            $ref: '#/components/schemas/TextPart'
      required:
      - parts
    JsonRpcResponse:
      type: object
      properties:
        jsonrpc:
          type: string
          enum:
          - '2.0'
        id:
          oneOf:
          - type: string
          - type: number
          - type: 'null'
        result:
          $ref: '#/components/schemas/AgentMessage'
        error:
          type: object
          properties:
            code:
              type: integer
            message:
              type: string
      required:
      - jsonrpc
    TextPart:
      type: object
      properties:
        kind:
          type: string
          enum:
          - text
        text:
          type: string
      required:
      - kind
      - text
    ServiceIndex:
      type: object
      properties:
        type:
          type: string
        agentCardUrl:
          type: string
          format: uri
        description:
          type: string
        endpoints:
          type: array
          items:
            type: object
            properties:
              method:
                type: string
              url:
                type: string
                format: uri
              description:
                type: string
        humanContact:
          type: object
        notes:
          type: array
          items:
            type: string
    Problem:
      type: object
      description: Fehlerobjekt nach RFC 9457 mit einem Hinweis, wie der Aufruf zu korrigieren ist.
      properties:
        type:
          type: string
          format: uri
        title:
          type: string
        status:
          type: integer
        code:
          type: string
        detail:
          type: string
        instance:
          type: string
        resolution:
          type: string
      required:
      - type
      - title
      - status
      - detail
    AgentMessage:
      type: object
      description: 'Antwort des Endpunkts: ein Textteil für Menschen, ein Datenteil für Maschinen.'
      properties:
        kind:
          type: string
          enum:
          - message
        role:
          type: string
          enum:
          - agent
        messageId:
          type: string
        contextId:
          type: string
        parts:
          type: array
          items:
            oneOf:
            - $ref: '#/components/schemas/TextPart'
            - $ref: '#/components/schemas/DataPart'
      required:
      - kind
      - role
      - messageId
      - parts
    SendMessageRequest:
      type: object
      properties:
        message:
          $ref: '#/components/schemas/UserMessage'
      required:
      - message
    DataPart:
      type: object
      properties:
        kind:
          type: string
          enum:
          - data
        data:
          type: object
      required:
      - kind
      - data
    Skills:
      type: object
      properties:
        agentCardUrl:
          type: string
          format: uri
        skills:
          type: array
          items:
            type: string
        processes:
          type: array
          items:
            type: string
        systems:
          type: array
          items:
            type: string
        notFitFor:
          type: array
          items:
            type: string
        requiredFacts:
          type: array
          items:
            type: string
  responses:
    Error:
      description: Fehler nach RFC 9457
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
externalDocs:
  description: Entwickler- und Agenten-Einstieg
  url: https://www.agentifizierung.de/developers
x-refined-from:
- agentifizierung-de-openapi.json
- agentifizierung-de.json
x-agent-card: https://www.agentifizierung.de/.well-known/agent-card.json
x-versioning: Pfadversionierung unter /a2a/v1. Ältere Versionen bleiben nach einer Ankündigung mindestens 12 Monate erreichbar.