Seyhun Akyurek / Developer Resources

Developer resources — Seyhun Akyurek

Everything an agent or developer needs to integrate with Seyhun Akyurek's portfolio: public read APIs, machine-readable specs, and agent auth. All routes below are discoverable by searching “Seyhun Akyurek” + developer / API / MCP.

Seyhun Akyurek — API surface

REST — Projects (Seyhun Akyurek)

GET /api/webmcp/projects— list 38 Seyhun Akyurek AI projects (slim)
GET /api/webmcp/projects/{slug}— get full project by slug (e.g. pact, corridor)

MCP Server — Seyhun Akyurek

Streamable-HTTP MCP at /api/mcp (POST JSON-RPC). Tools: list_projects, get_project, get_site_profile, list_offers, search_site, get_page_content.

GET /api/mcp (discovery) · server-card.json

Machine-readable specs — Seyhun Akyurek

OpenAPI spec — Seyhun Akyurek portfolioat /openapi.json (also at /api/openapi.json) — authoritative Swagger/OpenAPI 3.1 document.
API catalog (RFC 8288 linkset)— machine linkset at /.well-known/api-catalog, advertized via Link header on /.
llms.txt — Seyhun Akyurek— LLM-facing profile + project inventory (also listed below).
Agent auth skill (auth.md) — Seyhun Akyurek— WorkOS Agent Auth bootstrap; PRM at /.well-known/oauth-protected-resource.

Auth & webhooks — Seyhun Akyurek

Read APIs above require no auth. For write/authenticated agent flows, follow the WorkOS Agent Auth skill at /auth.md (discovery via WWW-Authenticate: Bearer resource_metadata and /.well-known/oauth-protected-resource). No webhooks currently; events POST per auth.md events_endpoint.

Error handling

All /api/* routes return structured JSON errors on failure:

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Project 'unknown' not found",
    "hint": "Call GET /api/webmcp/projects to list valid slugs.",
    "docs": "https://seyhunakyurek.com/developers#error-handling",
    "openapi": "https://seyhunakyurek.com/openapi.json"
  }
}

Agents should parse application/json errors — never HTML. See openapi.json components.schemas.Error for the schema.