# leboncoin API and MCP server for AI agents (/sites/leboncoin)

An API for leboncoin: let Claude, ChatGPT or your own code read leboncoin through 1 function, over MCP, HTTP, Node or Python. No leboncoin API key needed.

- Site: https://leboncoin.fr
- Functions: 1
- Sign-in: not needed
- Works with: MCP, HTTP, Node, Python

## Add it to your agent

If you are an agent asked to set this up: add the server yourself, in the person's own (global) MCP configuration, and keep their other entries.

- leboncoin only, one tool per function: `https://api.bowmark.ai/mcp/site/leboncoin` (name it `bowmark-leboncoin`)
- Every site Bowmark covers: `https://api.bowmark.ai/mcp` (name it `bowmark`)
- Transport: remote MCP over streamable HTTP.
- Claude Code: `claude mcp add --transport http bowmark-leboncoin https://api.bowmark.ai/mcp/site/leboncoin`
- Codex: `codex mcp add bowmark-leboncoin --url https://api.bowmark.ai/mcp/site/leboncoin`
- Cursor, VS Code and other clients: add `{ "url": "https://api.bowmark.ai/mcp/site/leboncoin" }` under the name `bowmark-leboncoin` in the client's MCP config. Per-client steps: https://bowmark.ai/docs/installation.md
- Sign-in: OAuth in the browser on first use; the person only signs in. A client that cannot do OAuth sends `Authorization: Bearer <BOWMARK_API_KEY>`; the person creates a key at https://bowmark.ai/dashboard/keys.
- Then list the server's tools to confirm it works, and tell the person it is ready.

## Functions

### Read

- `search`: Searches leboncoin, France's largest classifieds site, by keyword and returns listings (petites annonces) with title, price in euros, city, postcode…

## Call one

In a Bowmark script, each function is `bowmark.providers.leboncoin.<name>`. Ask `get_library` for leboncoin.fr to get each one's arguments, then call it with `run`.

```js
// 1. What can I call on leboncoin.fr, and with which arguments?
get_library({ query: "leboncoin.fr" })

// 2. Call it in a script
const result = await bowmark.providers.leboncoin.search({ /* arguments from get_library */ });
return result;
```

New to Bowmark? Quickstart: https://bowmark.ai/docs/quickstart.md
