Pionra

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Guides, housing, jobs, events and communities for foreigners living in France, in 6 languages.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Pionra": {
      "url": "https://pionra.world/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (8)

• search_pionra read-only

  Search Pionra guides, housing, jobs, communities, events, and directory pages with citation-ready links.

  Parameters:

  • query (required) — string — Natural-language search query.
  • lang — string — Locale for returned URLs and text: fr, en, zh, ar, pt or es. Optional — detected from the query when omitted.
  • limit — integer
  • intent — string — Optional result focus.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• list_communities read-only

  List Pionra country communities that match a query.

  Parameters:

  • lang — string — Locale for returned URLs and text: fr, en, zh, ar, pt or es. Optional — detected from the query when omitted.
  • limit — integer
  • query — string — Optional community, country, or diaspora query.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_community read-only

  Get a Pionra community hub plus recent posts for a given country code.

  Parameters:

  • country_code (required) — string — Two-letter ISO country code, for example CN or MA.
  • lang — string — Locale for returned URLs and text: fr, en, zh, ar, pt or es. Optional — detected from the query when omitted.
  • limit — integer

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• find_housing read-only

  Find housing listings on Pionra by city, budget, and room count.

  Parameters:

  • city — string
  • lang — string — Locale for returned URLs and text: fr, en, zh, ar, pt or es. Optional — detected from the query when omitted.
  • limit — integer
  • max_price — number
  • min_rooms — number

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• find_jobs read-only

  Find job listings on Pionra by city, language, and contract type.

  Parameters:

  • city — string
  • lang — string — Locale for returned URLs and text: fr, en, zh, ar, pt or es. Optional — detected from the query when omitted.
  • limit — integer
  • contract — string — Optional contract type such as CDI, CDD, stage, alternance, freelance, or interim.
  • language — string — Language code expected in the listing, for example fr or en.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• recent_events read-only

  List upcoming Pionra events, optionally filtered by city and date.

  Parameters:

  • city — string
  • date — string — Optional ISO date string.
  • lang — string — Locale for returned URLs and text: fr, en, zh, ar, pt or es. Optional — detected from the query when omitted.
  • limit — integer

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_guide read-only

  Fetch a full Pionra guide (Markdown body) by public id, or the best-matching guide for a search query. The text is returned in the requested locale when a translation exists.

  Parameters:

  • id — string — Optional guide public id.
  • lang — string — Locale for returned URLs and text: fr, en, zh, ar, pt or es. Optional — detected from the query when omitted.
  • query — string — Optional text query when the id is unknown.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• publish_guide

  Publish a guide, question, blog post, classified listing, marketplace item, or service offer to Pionra (enters the moderation queue before going live). Supports GUIDE, QUESTION, BLOG, ANNONCE, MARCHE, and SERVICE. Requires an API key sent as an `Authorization: Bearer pionra_sk_...` header — generate one at https://pionra.world/settings/developer. Same auth + rate limits as POST /api/ai/publish.

  Parameters:

  • type (required) — string — Post type.
  • category (required) — string — Active Pionra category slug (must be permitted by the API key).
  • title (required) — string — Post title, 5–200 characters.
  • bodyMarkdown (required) — string — Post body in Markdown, 20–20000 characters.
  • language (required) — string — Content language.
  • city — string — Optional free-form city label for ANNONCE, MARCHE, or SERVICE posts.
  • tags — array — Optional tags.
  • price — number — Optional price amount.
  • cityScope — string — Optional city slug to scope the post.
  • expiresAt — string — Optional ISO date or date-time when the post should expire.
  • jobRemote — string — Optional remote mode label, for example onsite, hybrid, or remote.
  • coverEmoji — string — Optional cover emoji, up to 16 characters.
  • negotiable — boolean — Optional negotiable flag for classified-style posts.
  • cover_emoji — string — Alias for coverEmoji.
  • housingType — string — Optional housing type, for example studio, chambre, or colocation.
  • countryScope — string — Optional ISO country code to scope the post.
  • housingRooms — number — Optional room count. Stored as an integer.
  • housing_city — string — Alias for city.
  • housing_rent — number — Alias for price.
  • jobSalaryMax — number — Optional maximum salary. Stored as an integer.
  • jobSalaryMin — number — Optional minimum salary. Stored as an integer.
  • locationCity — string — Optional location label shown on the post; defaults to city.
  • metroStation — string — Optional nearby metro or transit station.
  • coverImageUrl — string — Optional cover image. Must be a public https:// URL to an image (jpeg/png/webp/gif/avif, max 8MB). Pionra fetches it server-side and stores it as the post cover; takes precedence over coverEmoji.
  • housing_metro — string — Alias for metroStation.
  • priceCurrency — string — Optional ISO currency code. Defaults to EUR for ANNONCE, MARCHE, and SERVICE.
  • housingDeposit — number — Optional housing deposit amount.
  • housingSurface — number — Optional housing surface area. Stored as an integer.
  • cover_image_url — string — Alias for coverImageUrl.
  • jobContractType — string — Optional job or service contract type.
  • housingFurnished — boolean — Optional furnished flag.
  • housingAvailableFrom — string — Optional ISO date or date-time when the housing becomes available.
  • housing_available_at — string — Alias for housingAvailableFrom.

  Hints: read-only no · destructive no · idempotent no · open-world yes

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.