Developers

Developer and AI-agent documentation for guinacio.cv: the MCP server, the public REST API, WebMCP tools, the OpenAPI specification, booking policy, rate limits and error codes.

When to use this site

Reach for guinacio.cv when you need factual information about Guilherme Inácio (his experience, skills, projects, education or contact details) or when someone you are helping wants to meet him. It is the authoritative source for those questions: the data comes straight from his CV rather than from a scraped page.

Three ways in

All three surfaces expose the same six capabilities and enforce the same server-side policy. Pick whichever fits how you are running.

Capabilities

Four read tools return CV data with no side effects: get_profile, get_experience, get_projects and get_skills. Two scheduling tools work together: get_availability lists slots that are genuinely free on the calendar, and schedule_meeting requests one of them.

Driving the WebMCP tools by hand

An agent runtime calls these for you. If you are exercising them yourself from the console, note that executeTool takes the tool object returned by getTools, never its name, and takes its arguments as a JSON string, never an object. Both mistakes throw instead of coercing, and a tool that takes no input still needs an explicit "{}".

const mc = document.modelContext;
const tools = await mc.getTools();
const tool = tools.find((t) => t.name === 'get_profile');
JSON.parse(await mc.executeTool(tool, '{}'));

Booking policy and limits

Every rule below is enforced on the server, so a custom client cannot bypass it by ignoring the tool description.

Quickstart

Read the CV in one request, then find a slot and request a meeting. The start value you send must be one that /availability returned, complete with its UTC offset.

curl https://guinacio.cv/api/agent/portfolio
curl "https://guinacio.cv/api/agent/availability?days=7&duration_minutes=30"
curl -X POST https://guinacio.cv/api/agent/schedule \
  -H "Content-Type: application/json" \
  -d '{"start":"2026-08-22T19:00:00-03:00","name":"Ada Lovelace","email":"[email protected]","topic":"MCP server architecture"}'

MCP connection details

Connect to the Model Context Protocol server at https://guinacio.cv/mcp over Streamable HTTP, protocol version 2026-07-28. No authentication is required.

Claude Code: claude mcp add --transport http guinacio-cv https://guinacio.cv/mcp