# Protico Public API Docs

Protico publishes two public, agent-facing interfaces from `protico.io`:

## 1. Live Community Feed API

- Endpoint: `https://main.protico.io/api/live-community-feed/`
- Method: `GET`
- Query parameter: `roomUrl` (required, full HTTPS page URL)
- Purpose: Return the public discussion feed associated with a Protico-enabled partner page or article.

Example:

```bash
curl "https://main.protico.io/api/live-community-feed/?roomUrl=https://protico.io/"
```

Machine-readable description:

- OpenAPI: `/openapi/protico-live-community-feed.yaml`
- Status probe: `/api/status/live-community-feed`

## 2. Protico Discovery MCP Server

- Endpoint: `/mcp`
- Transport: Streamable HTTP
- Auth: none required for the public discovery tools

Available tools:

1. `list_agent_resources`
2. `build_community_feed_url`
3. `list_partner_sites`
4. `get_agent_identity_guidelines`

Discovery documents:

- Server card: `/.well-known/mcp/server-card.json`
- Agent skills index: `/.well-known/agent-skills/index.json`
- API catalog: `/.well-known/api-catalog`

## Related Agent Docs

- `/llms.txt`
- `/agents.txt`
- `/agent-manifest.json`
- `/skill.md`