# Prosyo Agent API

Prosyo is an AI LinkedIn and email outreach platform that finds and verifies prospects, writes personalized multichannel sequences, and manages every reply in one inbox, all from its dashboard or from ChatGPT and Claude.

A public, read-only API over the published content of Prosyo. No authentication. Responses are JSON unless noted; CORS is open.

## Endpoints

### `GET https://prosyo.com/ai/search?q={words}&type={type}&limit={1-20}`

Search published content. Returns `query`, `total` and `results[]` (`title`, `url`, `type`, `typeLabel`, `summary`, `published`, `modified`).

### `GET https://prosyo.com/ai/page?url={url or /path/}`

One page as Markdown (`text/markdown`, with `x-markdown-tokens`). Add `&format=json` for `{url, title, tokens, markdown}`. Only pages on this site.

### `GET https://prosyo.com/ai/content?type={type}&limit={1-50}&page={n}`

Newest items of one content type. Types: `post`, `page`, `compare`, `tools`, `case_study`, `integration`.

### `GET https://prosyo.com/ai/overview`

What the site is, its main pages, content types and resource URLs.

### `GET https://prosyo.com/ai/health`

`{"status":"ok"}` while the API is up.

### `POST https://prosyo.com/ai/mcp`

Model Context Protocol, Streamable HTTP transport with JSON responses (no SSE, no session). Tools: `search_site`, `get_page`, `list_content`, `site_overview`. Card: https://prosyo.com/.well-known/mcp/server-card.json

### `POST https://prosyo.com/ai/a2a`

Agent2Agent JSON-RPC (protocol 1.0, `SendMessage`; `message/send` also accepted). Card: https://prosyo.com/.well-known/agent-card.json

## Markdown for any page

Every page also answers `Accept: text/markdown` with Markdown at its own URL.

## Errors

`{"error": "code", "message": "..."}` with status 400 (bad input), 404 (not found) or 405 (wrong method).

## Machine-readable

- OpenAPI 3.1: https://prosyo.com/ai/openapi.json
- API catalog: https://prosyo.com/.well-known/api-catalog
- Authentication: https://prosyo.com/auth.md