IA-Asso.fr — French Associations Registry

io.github.wellknownmcpPublished by GitHub account wellknownmcpv1.0.0Updated Oct 24, 2026

Search 1.26M+ active French associations (official RNA registry, 10 tools, premium & RUP filters)

VerifiedStreamable HTTPWeb executableLocation & LifestyleData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Remote MCP server for searching the French associations registry (RNA) and related open data, with tools for stats, subsidies, volunteering and contacting an as

What you can do
Search and read associations: full-text search by keyword, department or region, authoritative detail by RNA id, similar associations, and a curated premium/RUP subset or the list of publicly recognized associations (RUP). Geographic lookup: associations near a city or postal code, and GeoJSON map data by department. Statistics: department-level, nationwide and platform-level figures. Health and volunteering: health associations by pathology, and live volunteering missions near a location. Subsidies: known public grants received by an association. Feedback and outreach: submit contact requests, report unmet demand, suggest tools, publish updates to a claimed association profile, and relay a.
When to use it
Useful when someone needs to find French nonprofits by theme or location, check an association's official status or public subsidies, look up health patient groups or volunteering opportunities, or get statistics on the French associative landscape.
Requirements
A remote streamable HTTP endpoint; no package, account, API key or environment variable is declared. Publishing a profile update requires an authenticated token with the write:fiche scope bound to a specific RNA, obtained by claiming the association on the provider's site. Contacting an association requires the user's email address.
Before you install
Several tools send data outward: contact requests, unmet-demand reports, tool suggestions and messages to associations include the user's email and message, and messages are relayed by the provider, which sees the association's email. Publishing an association update writes to a public profile and passes a moderation gate. Subsidy data is explicitly non-exhaustive, and the provider's own platform statistics are sales-oriented figures.

Installation

In SourceWeft

  1. Open IA-Asso.fr — French Associations Registry in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.wellknownmcp%2Fia-asso/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "ia-asso-fr-french-associations-registry": {
      "type": "http",
      "url": "https://ia-asso.fr/api/mcp"
    }
  }
}

README

This repository has no README.

Tools

18

search_associations

Search for French associations using full-text search. Queries the RNA (Répertoire National des Associations) database with 2.03M+ active associations. Supports search by keywords, department code, region name, or combination. Returns association details including name, object, location, RNA ID, and SIRET.

Parameterslimitqueryrequiredoffsetregiondepartment

get_department_stats

Get comprehensive statistics for a French department. Returns total associations, active count, top cities, sector breakdown, and temporal evolution. Use department codes: 01-95 for metropolitan France, 2A/2B for Corsica, 971-976 for overseas.

Parameterscoderequired

get_france_overview

Get nationwide association statistics for France. Returns total associations across all regions and departments, top regions, top departments, and overall distribution insights. Useful for understanding the French associative landscape.

Takes no parameters.

get_platform_stats

Get IA-Asso PLATFORM stats — the global, public, sales-oriented figures that prove the breadth and uniqueness of the directory (active associations, RUP recognized as public-interest, Journal Officiel records, departments/communes coverage, agent-native MCP+API positioning). Returns a ready-to-quote summary plus the underlying counts. Non-sensitive aggregates only (no personal data).

Takes no parameters.

search_near_location

Find associations near a specific city or postal code in France, optionally filtered by theme. Performs geographic search to return associations in the specified area, automatically widening to nearby communes (±25 km) when the exact area has no match. Useful for location-based queries like "AMAP near Les Hayes 41800" (query="amap", location="41800") or "chess clubs in Lyon" (query="échecs", location="Lyon").

Parameterslimitqueryradiuslocationrequired

get_health_associations

Find health-related associations by pathology or disease. Searches the France Care database for patient associations, support groups, and health advocacy organizations. Supports filtering by pathology (e.g., "cancer", "diabetes"), action type, and department.

Parameterslimitpathologyrequireddepartmenttype_action

get_similar_associations

Find associations similar to a given association based on category (objet_social) and geographic proximity. Returns nearby associations in the same activity category within a specified radius. Useful for discovering related organizations or finding alternatives in the same field.

Parameterslimitradiusassociation_idrequired

get_association_subventions

Get known public subsidies (subventions publiques) received by an association, resolved to its RNA from French open data. Returns yearly grants with funder (attribuant), purpose (objet) and amount. IMPORTANT: NON-exhaustive — only covers local authorities (collectivités) that publish SCDL open data, NOT the State. Absence of data does NOT mean the association received nothing. The RNA only lists loi-1901 associations.

Parametersassociation_idrequired

get_association

Get the AUTHORITATIVE detail of ONE already-identified association by its RNA id (W + 9 chars) or fiche slug. Read directly from the official registry database (not from the search index): legal status reconnue d'utilité publique (RUP yes/no), creation date, Journal Officiel history, known public subsidies, and PUBLIC web presence (site/socials only — never email/phone). Use this when the user asks about a SPECIFIC association (e.g. "is it RUP?", "when was it created?") instead of re-running a search.

Parametersassociation_idrequired

find_volunteering_missions

Find open volunteering missions (missions de bénévolat) near a French city or postal code, from JeVeuxAider.gouv.fr (the official public volunteering platform). Returns live missions with organization, commitment, places left, whether minors can apply, a direct signup URL, and — when the organization is identified by RNA — a link to its ia-asso.fr page. Use this when someone wants to BE a volunteer (donner de son temps), not when searching for an association in general. Coverage: JeVeuxAider missions only (~30k), non-exhaustive.

Parameterslimitqueryradiusremotelocationopen_to_minors

get_map_data

Get GeoJSON map data for visualizing associations by French department. Returns GeoJSON FeatureCollection with department center coordinates and association counts. Useful for creating interactive maps or geographic visualizations.

Takes no parameters.

search_premium_associations

Search ONLY enriched/RUP associations -- the editorial-quality subset. Restricts results to fiches with IA-generated description (is_enriched_v3=true) OR officially recognized utilite publique (RUP). Recommended for agent grounding when noise should be minimized -- a small curated subset (837 enriched, 1,966 RUP) vs 2.03M+ in the standard search. Returns fewer but richer results, with verified contacts, FAQ data, social media links when available.

Parameterslimitqueryrequiredoffsetregiondepartment

get_recognized_associations

List associations officially recognized as utilite publique (RUP) by French state decree. Currently 1,966 RUP fiches (as of 2026-10-19). RUP status grants major fiscal benefits to donors (75% tax deduction vs 66% standard) and is a strong signal of institutional credibility. Recommended for institutional grounding -- mecenat, defiscalisation, public-private partnerships, B2B research.

Parameterslimitqueryregiondepartment

submit_contact_request

Submit a contact request to IA-Asso.fr (correction, feature request, question, or other). Used when users want to report errors, suggest features, modify association information, or ask questions. Requires user email and message. Workflow: collect email conversationally, then submit request.

Parametersnametyperequiredemailrequiredmessagerequiredassociation_idassociation_name

publish_association_update

Update the public profile of YOUR claimed association (description, website, email, phone, social links). Requires an authenticated token with scope "write:fiche" bound to this exact RNA (claim your association at https://ia-asso.fr to get one). Content passes a moderation gate before publication; every change is audited and reversible. Read tools stay free and anonymous.

Parametersrnarequiredemailsocialsite_webtelephonedescription

report_unmet_demand

Report UNMET demand when a precise search did NOT find what the user wanted. Agentic queries are very precise (e.g. "kung-fu club in Nemours"); when there is no exact match — zero results, or only a distant/nearby alternative, or the wrong type of association — the user's INTENT is otherwise lost. Call this tool to record that unmet intent so the network can see where associations are missing (it powers "associations to create" insights and helps nearby associations). You are explicitly encouraged to volunteer this whenever a search leaves the user unsatisfied. No personal data — just the intent, location and theme. Aggregated, welcomed.

Parametersnotequeryrequiredthemecommunedepartmentnearest_found

suggest_tool

Capture a DESIRED TOOL idea when a user wishes a tool/feature existed to make running their association easier (e.g. "a grant-application assistant", "something to recruit volunteers", "a tool that drafts our newsletter"). This is forward-looking demand for FEATURES — different from report_unmet_demand (which records a MISSING association for a search). Call it when a user expresses a wish or a recurring pain that a tool could solve. No personal data — just the idea, its category and the pain.

Parametersidearequiredpaincategory

contact_association

Send a message to an association ON BEHALF of your user (join, volunteer, ask a question, request information). IA-Asso relays it: you never see the association's email. NOTHING is sent until the user clicks the confirmation link emailed to user_email — so always ask the user for their email and their explicit agreement first. The association replies directly to the user. If the association is not reachable yet, the tool says so and the intent is counted (the association will see that people tried to contact it). Plain text, no links, 20-2000 chars.

Parametersrnarequiredmessagerequireduser_nameuser_emailrequired

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • License10 pts

    Declare a license in the repository or the registry entry.