AGENT

Agent Integration Guide

WPORT is more than an API — it ships the mechanisms that let AI agents discover, read and operate the platform on their own. Here are the four core pieces.

① .well-known discovery chain

From the API catalog an agent discovers the OpenAPI schema and Agent Skills — no hard-coded endpoints:

bash
curl https://wport.me/.well-known/api-catalog
#  → openapi.json  → agent-skills/
  • /.well-known/api-catalog — capability catalog entry
  • /.well-known/openapi.json — full OpenAPI schema
  • /.well-known/agent-skills/ — integration discovery skills (api-discovery, oauth-authentication, mcp-discovery, markdown-negotiation)
  • /.well-known/mcp/server-card.json — MCP server discovery card

② Agent Skills

wport-agents ships pluggable skills that move an agent from answering to actually getting things done:

interviewer-aiMock technical interviews with instant feedback
gen-career-mentorCareer-path advice based on your skills
exec-wport-cliSkill drives the CLI to fetch data
gen-resumeGenerate a resume from a conversation
gen-resume-optimizerOptimize a resume for a job

Each skill is a SKILL.md that an AI agent (e.g. Claude) loads to use. See the full list and usage in the wport-agents repository: github.com/hotfire-digital/wport-agents

③ WebMCP browser tools

The WPORT site registers tools in the browser via the W3C WebMCP standard (navigator.modelContext). These tools are navigational — they take the browser to the right page and return the current page context (path / url / title); they are not data-returning query APIs:

javascript
// app/plugins/webmcp.client.ts
navigator.modelContext.provideContext({ tools })
//  → open-jobs-list({ keyword, page })
//  → open-job-detail({ id })
//  → open-company-detail({ id })
//  → open-auth({ tab, redirect })
//  → get-current-page-context()

On the server side, an MCP discovery card at /.well-known/mcp/server-card.json advertises the streamable-http transport and capabilities to external MCP clients.

④ Markdown content negotiation

Send Accept: text/markdown and pages return LLM-friendly plain-text Markdown — no HTML parsing needed:

bash
curl -H "Accept: text/markdown" https://wport.me/jobs

Call the agent endpoint

For programmatic integration, /api/agent provides an agent-oriented entry point; the schema is always defined by .well-known/openapi.json.

See also