Skip to main content
You need a Locus API key — a bearer token of the form lsk_<slug>_<random>. See Authentication for how keys work.
Base URL used throughout: https://core.locusmedical.fr. Replace it with your deployment’s URL if different.

​
1. Call the REST API

curl -X POST https://core.locusmedical.fr/v1/search \
  -H "Authorization: Bearer $LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "antibioprophylaxie chirurgie colorectale", "limit": 5}'
Every endpoint returns structured JSON. Explore them all, with a live request runner, in the API Reference tab.

​
2. Try it in the playground

The API Reference tab renders each endpoint with an interactive playground. Click Authorization, paste your lsk_… key, and run a request without leaving the docs.

​
3. Connect an MCP client

The same capabilities are exposed as MCP tools over Streamable HTTP at /mcp. 
{
  "mcpServers": {
    "locus": {
      "url": "https://mcp.locusmedical.fr/mcp",
      "headers": { "Authorization": "Bearer ${LOCUS_API_KEY}" }
    }
  }
}
See MCP server for the tool catalogue and routing guidance.

​
Next steps

Authentication

Key format, hashing, rate limits.

Capabilities

What each endpoint does and when to use it.