# Scout Mesh developer resources

Scout Mesh is a sourcing MCP gateway. Agents and developers use this page to find the OpenAPI spec, the public REST catalog, MCP connection details, and authentication.

## When to use Scout Mesh

Use Scout Mesh when a recruiter or sourcer needs people, companies, or contact data inside Claude, ChatGPT, or another MCP client. Use it to search GitHub, People Data Labs, Lusha, prog.ai, and the other connected sources through one endpoint and one balance. Do not use it as an ATS, background check, or consumer-reporting system.

## Public REST API

Unauthenticated JSON at `/api/v1`. Agents can list sources and read product metadata without an account.

```bash
curl -s https://getscoutmesh.com/api/v1
curl -s https://getscoutmesh.com/api/v1/sources
```

- [API index](https://getscoutmesh.com/api/v1)
- [Sources](https://getscoutmesh.com/api/v1/sources)
- [OpenAPI](https://getscoutmesh.com/openapi.json)

Candidate search and enrichment still run through the MCP server, not this catalog API.

## OpenAPI specification

The machine-readable contract is [Scout Mesh OpenAPI](https://getscoutmesh.com/openapi.json) (`openapi: 3.1.0`). Publish path: `/openapi.json`.

## MCP server

Remote MCP URL: `https://mcp.getscoutmesh.com/mcp`

After sign-up, the setup page gives a personal URL with the API key in the path:

`https://mcp.getscoutmesh.com/mcp/{api_key}`

Paste that URL into Claude or ChatGPT as a custom connector. Authentication is "none" in the client because the key is already in the URL. Treat the URL like a password. OAuth is also offered by the live MCP endpoint when a client starts the initialize handshake without a key.

## Authentication

- **Public catalog API:** no auth. `GET /api/v1`, `GET /api/v1/sources`, `GET /openapi.json`.
- **MCP tools:** API key in the personal MCP URL, or the MCP OAuth challenge on `https://mcp.getscoutmesh.com/mcp`.
- **Web app:** WorkOS AuthKit session for `/overview` and other signed-in pages.

There is no public webhook subscription in this product.

## Markdown and llms.txt

HTML pages also serve `text/markdown` when the client sends `Accept: text/markdown`. Sibling files use a `.md` suffix, for example [the homepage markdown](https://getscoutmesh.com/index.md). The index for agents is [llms.txt](https://getscoutmesh.com/llms.txt).

Contact: [contact@reppls.com](mailto:contact@reppls.com)

## Sitemap

- [Home](https://getscoutmesh.com/index.md)
- [Scout Mesh developer resources](https://getscoutmesh.com/developers.md)
- [Sources](https://getscoutmesh.com/sources.md)
- [Guides](https://getscoutmesh.com/guides.md)
- [OpenAPI specification](https://getscoutmesh.com/openapi.json)
- [llms.txt](https://getscoutmesh.com/llms.txt)