API & Agent Docs

Machine-readable interfaces for profile discovery, site search, and agent tooling

This site publishes a public JSON API, an MCP endpoint, agent skills metadata, and discovery documents for crawlers and AI agents.

Public API

Base URL: https://soyanalaura.com/api

  • GET /api/health returns service status and discovery endpoints.
  • GET /api/profile returns bilingual profile metadata and practice areas.
  • GET /api/practice-areas?locale=es|en returns localized practice areas.
  • GET /api/publications?locale=es|en returns publication metadata and PDF links.
  • GET /api/contact-options?locale=es|en returns public contact and booking options.
  • GET /api/search?q=<query>&locale=es|en returns relevant public-site matches.

OpenAPI description: https://soyanalaura.com/openapi.json

API catalog: /.well-known/api-catalog

Health endpoint: https://soyanalaura.com/api/health

MCP & WebMCP

  • POST https://soyanalaura.com/mcp supports initialize, tools/list, and tools/call.
  • /.well-known/mcp/server-card.json publishes the server card for agent discovery.
  • Browser agents can discover WebMCP tools on page load for profile overview, practice areas, publications, contact options, and site search.

OAuth Discovery Surface

Protected resource identifier: https://soyanalaura.com/api/agent

The protected namespace is reserved for future agent-specific workflows. This deployment publishes discovery metadata so clients can locate the future auth surface programmatically.