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
  • getProfileData: Retrieve all professional data (projects, blog, experience, publications, skills) in JSON.
  • getRecentPosts: Get the most recent blog articles (parameter: limit).
  • getProjects: Get the list of projects, optionally filtered by technology (parameters: tech, limit).
  • getConferences: Get the list of conferences and talks (parameter: limit).
  • list_projects, get_project_context, get_pending_tasks: Query the active control center hub and pending developer task queue.
  • list_skills, search_skills: Browse and search specific agent skills.
  • trigger_sync, get_sync_status: Manage background data synchronization.

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 Plugin (Agent Plugins 1.0.0): /.well-known/agent-plugin/plugin.json
  • Agent Card (Legacy): /.well-known/agent.json and /.well-known/agent-card.json
  • RFC 8288 Link Headers:
    • agent-plugin: https://davidbuenov.com/.well-known/agent-plugin/plugin.json
    • 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
Abrir chat con Victoria