Search French associations by name
search_french_associationsIdentify French associations by name in the RNA registry, filter by postal code, department, or status, and return up to 20 matches with confidence scores and RNA numbers.
Instructions
Use FIRST whenever a French association (loi 1901, nonprofit, charity, club) is mentioned by NAME without an identifier. Searches the Répertoire national des associations (RNA) by normalised title prefix first, then by trigram similarity for similar titles (each result says which in correspondance), with optional postal-code, department and position filters applied before the cut. Returns up to 20 matches with score_confiance (0-1) and the RNA number to pass to get_french_association_profile or get_french_association_notices; siren when Sirene confirms it. total_results counts, before the cut, every title that passes the query and the filters in the pool of each stage run, a typed RNA number included (served and counted even outside the filters); it is a lower bound (listes_bornees.resultats) when a stage finds more than 3000 filtered titles or is abandoned. Associations with AND without a SIREN; the legacy file (no declaration since 2009) is flagged fichier_source: import. Paid via x402 ($0.002 in USDC or EURC). When you report a result, cite its citation verbatim.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"q": "<q>"
},
"name": "search_french_associations"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | Yes | Association title, or an RNA number (resolved directly). Unsupported characters are stripped, not rejected. | |
| position | No | Position filter; default all | |
| code_postal | No | Postal code or prefix (2-5 digits) of the registered office | |
| departement | No | Registered-office departement, by postal code: 01-19, 21-95, 971-978; 2A, 2B, 984, 986-989 refused for now (400 departement_non_servi, not charged); code_postal wins over a served departement; any other departement is refused, even with code_postal |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hint | No | How to settle the quote, present when payment_required is true. | |
| quote | No | The signable x402 payment requirements when payment_required is true: {x402Version, accepts[]} where each entry carries scheme, network, amount, asset and payTo (USDC and EURC options at the same numeric amount). Sign one entry and call again with `x_payment`. | |
| resultat | No | The endpoint's JSON response when payment_required is false. Paid responses carry `source`, `disclaimer` and an Ed25519 signature, and every paid JSON response carries a `provenance` array (all tools since 2026-09-06): one entry per block served, with the official register, licence, version, `empreinte_sha256` (full snapshots), `as_of` date and `precision_as_of` (what that date means), plus the common per-block envelope: `etat` in a closed list (servi, absence_mesuree, absence_non_conclusive, partiel, perime, indisponible, sans_objet), `motif` when unavailable, `age_jours` (only for publication or ingestion dates), `couverture` (complete / partielle / non_mesurable with its measure) and `confiance` in bands (faible / moyenne / forte, only where a measure grounds it, never averaged across blocks). Read the states before the numbers: an absence_non_conclusive, indisponible or partiel block is never « nothing to report »; only absence_mesuree asserts an absence. Register codes: GET /v1/provenance/registres ; states, closed lists and reading rules: GET /v1/lecture (both free). The PDF tools carry no JSON envelope (the PDF report prints it). | |
| free_tier | No | Free API key offer for this tool, present with a quote. | |
| payment_required | Yes | True when this response is an x402 payment quote instead of data: settle one of the quote's `accepts` options and call the tool again with `x_payment`. |