# llmsmap distribution

![llmsmap mark](assets/logo-512.svg)

Public integration metadata for [llmsmap.me](https://llmsmap.me/) and [llmsmap.ru](https://llmsmap.ru/).

This repository intentionally contains no application source code, deployment configuration, database content, or secrets. It distributes the public MCP manifests, the canonical OpenAPI contract, a derived Postman collection, and brand assets.

## MCP

llmsmap exposes read-only catalog search through MCP Streamable HTTP. Both canonical URLs include a trailing slash; the service also accepts the non-slash form directly without an HTTP redirect.

| Edition | Scope | Endpoint | Manifest |
| --- | --- | --- | --- |
| International | International sites, excluding the Russian catalog segment | `https://llmsmap.me/api/mcp/` | [server.json](server.json) |
| Russian | Russian and international catalog segments | `https://llmsmap.ru/api/mcp/` | [servers/llmsmap-ru.server.json](servers/llmsmap-ru.server.json) |

Example remote-server configuration:

```json
{
  "mcpServers": {
    "llmsmap": {
      "url": "https://llmsmap.me/api/mcp/"
    }
  }
}
```

Available tools:

- `list_catalog` — list approved catalog entries, up to 50 per call.
- `search_catalog` — search by product name or URL, up to 50 per call.

The server is stateless, public, read-only, and does not require an API key. Clients should cache stable results and retry temporary failures with exponential backoff.

## REST API

- Canonical OpenAPI 3.1 contract: [openapi.json](openapi.json)
- Live specification: [llmsmap.me/openapi.json](https://llmsmap.me/openapi.json)
- Human documentation: [llmsmap.me/api-docs/](https://llmsmap.me/api-docs/)
- Postman collection: [postman/llmsmap.postman_collection.json](postman/llmsmap.postman_collection.json)

The OpenAPI document is the source of truth. The Postman collection is a distribution derivative and must be updated when the OpenAPI contract changes.

## Status of llms.txt

llms.txt is an emerging convention proposed by [llmstxt.org](https://llmstxt.org/), not a formal web standard. Publishing llms.txt may reduce discovery friction for compatible tools; it does not guarantee crawling, indexing, ranking, citation, or inclusion in AI-generated answers.

## Support

Use the [contact form](https://llmsmap.me/contacts/) for general support.

<details>
<summary>Reveal the direct contact address</summary>

`hello [at] llmsmap [dot] me`

</details>

The address is obfuscated in repository source to reduce basic automated harvesting. Until the mailbox is activated, use the contact form.

For security reports, follow [SECURITY.md](SECURITY.md). For integration questions, see [SUPPORT.md](SUPPORT.md).

## Screenshots

Screenshots are intentionally deferred until the catalog, audit, and generator views share the final visual system.