# ReachSocial agent guide

ReachSocial is a paid, provider-neutral social-data surface. Inspect the executable catalog before choosing a service.

## Safe workflow

1. Fetch `https://reachsocial.dev/v1/services`; do not infer availability from the roadmap.
2. Resolve or normalize the requested public social URL.
3. Select the smallest service and submit only its documented fields.
4. Reuse one idempotency key for retries of the same logical request.
5. Compare every x402 retry requirement with the original amount, asset, network, receiver, and resource before signing.
6. Poll accepted jobs rather than repeating their paid POST.
7. Treat `private`, `not_found`, and `invalid_input` as terminal; retry only errors explicitly marked retryable.

## Discovery

- Human documentation: https://reachsocial.dev/docs/api
- OpenAPI: https://reachsocial.dev/openapi.json
- LLM index: https://reachsocial.dev/llms.txt
- Catalog: https://reachsocial.dev/v1/catalog
- Operational status: https://reachsocial.dev/status.json
- MCP server card: https://reachsocial.dev/.well-known/mcp.json

Currently available services: instagram.profile, instagram.post, linkedin.profile.
MCP is an authenticated B2B surface and may be disabled. A 503 server-card or MCP response means use REST, not that a public unauthenticated MCP endpoint exists.