API Documentation

Welcome to the API Documentation for davidbuenov.com. This site offers public JSON endpoints and Model Context Protocol (MCP) integrations to support AI agents and applications.

1. Public Data API

We provide a comprehensive data catalog containing David Bueno Vallejo's portfolio, blog posts, projects, awards, publications, and professional background.

Fetch Portfolio Data

Endpoint: https://davidbuenov.com/api/data.json
Method: GET
Headers: Accept: application/json

Description: Returns all projects, blog articles, awards, conference list, professional services, and training sessions in a structured JSON schema.

2. Model Context Protocol (MCP)

This site exposes an MCP server for agents to query and search David's professional materials programmatically.

MCP Configuration

Server Discovery URI: /.well-known/mcp.json
Specification Version: 1.0.0

Available MCP Tools

getPortfolio: Retrieve all portfolio items, projects, and conferences.
searchPortfolio: Search projects, articles, and training sessions by query keywords (parameter: query).

3. Agent-to-Agent (A2A) Discovery

To help AI agents understand the capabilities and metadata of this website, we publish standard discovery cards and headers:

Agent Card: /.well-known/agent.json and /.well-known/agent-card.json
RFC 8288 Link Headers:
- agent-skills: https://davidbuenov.com/.well-known/agent-skills/index.json
- mcp-server: https://davidbuenov.com/.well-known/mcp.json
- agent: https://davidbuenov.com/.well-known/agent-card.json
- api-catalog: https://davidbuenov.com/.well-known/api-catalog