Pentru agenti AI

Documentatia canonica pentru agenti: MCP endpoint public read-only, unelte, resurse, exemple JSON-RPC si fallback REST.

MCP

• Endpoint: https://mmatinca.eu/mcp
• Transport: Streamable HTTP (stateless, POST)
• Authentication: none (read-only, public data)
• Default language: English (content in en + ro)
• Rate limit: 60 req/min
• Registry: eu.mmatinca/portfolio-mcp
• Server card: https://mmatinca.eu/.well-known/mcp/server-card.json

Tools

• portfolio_search — full-text search across projects, blog, experience, certifications and results
• portfolio_get_profile — career history, certifications, measurable results
• portfolio_list_projects — all projects with id, title, category, result, tags
• portfolio_get_project — one project in full (markdown description, details)
• portfolio_list_blog_posts — published articles with slug, title, excerpt
• portfolio_get_blog_post — one article in full markdown

Resources

• portfolio://profile/{lang}
• portfolio://projects
• portfolio://projects/{id}/{lang}
• portfolio://blog
• portfolio://blog/{slug}/{lang}

Example

curl -X POST https://mmatinca.eu/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"portfolio_search","arguments":{"query":"EU AI Act","lang":"en","limit":5}}}'

REST fallback

• https://mmatinca.eu/openapi.json (OpenAPI 3.1)
• https://mmatinca.eu/.well-known/api-catalog (RFC 9727)
• https://mmatinca.eu/llms.txt
• Markdown negotiation: request any page with Accept: text/markdown

There is no OAuth and no agent registration — intentionally: writing is a single-user personal admin surface, not a public one.