Pionra
Guides, housing, jobs, events and communities for foreigners living in France, in 6 languages.
Should I use this
Quality & Safety
Findings (2)
- HIGH
- MEDIUMin publish_guide
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"pionra": {
"url": "https://pionra.world/mcp"
}
}
}Remote endpoints
https://pionra.world/mcpstreamable-httpWhat it can do
Tool inventory
Tools (8)
🟢search_pionra(query, intent, lang, limit)
Search Pionra guides, housing, jobs, communities, events, and directory pages with citation-ready links.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Natural-language search query."
},
"intent": {
"type": "string",
"enum": [
"all",
"housing",
"jobs",
"community",
"visa"
],
"description": "Optional result focus."
},
"lang": {
"type": "string",
"enum": [
"fr",
"en",
"zh",
"ar",
"pt",
"es"
],
"description": "Locale for returned URLs and text: fr, en, zh, ar, pt or es. Optional — detected from the query when omitted."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 20
}
},
"required": [
"query"
],
"additionalProperties": false
}🟢list_communities(query, lang, limit)
List Pionra country communities that match a query.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Optional community, country, or diaspora query."
},
"lang": {
"type": "string",
"enum": [
"fr",
"en",
"zh",
"ar",
"pt",
"es"
],
"description": "Locale for returned URLs and text: fr, en, zh, ar, pt or es. Optional — detected from the query when omitted."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 20
}
},
"additionalProperties": false
}🟢get_community(country_code, lang, limit)
Get a Pionra community hub plus recent posts for a given country code.
Input Schema
{
"type": "object",
"properties": {
"country_code": {
"type": "string",
"description": "Two-letter ISO country code, for example CN or MA."
},
"lang": {
"type": "string",
"enum": [
"fr",
"en",
"zh",
"ar",
"pt",
"es"
],
"description": "Locale for returned URLs and text: fr, en, zh, ar, pt or es. Optional — detected from the query when omitted."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 20
}
},
"required": [
"country_code"
],
"additionalProperties": false
}🟢find_housing(city, max_price, min_rooms, lang, limit)
Find housing listings on Pionra by city, budget, and room count.
Input Schema
{
"type": "object",
"properties": {
"city": {
"type": "string"
},
"max_price": {
"type": "number"
},
"min_rooms": {
"type": "number"
},
"lang": {
"type": "string",
"enum": [
"fr",
"en",
"zh",
"ar",
"pt",
"es"
],
"description": "Locale for returned URLs and text: fr, en, zh, ar, pt or es. Optional — detected from the query when omitted."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 20
}
},
"additionalProperties": false
}🟢find_jobs(city, language, contract, lang, limit)
Find job listings on Pionra by city, language, and contract type.
Input Schema
{
"type": "object",
"properties": {
"city": {
"type": "string"
},
"language": {
"type": "string",
"description": "Language code expected in the listing, for example fr or en."
},
"contract": {
"type": "string",
"description": "Optional contract type such as CDI, CDD, stage, alternance, freelance, or interim."
},
"lang": {
"type": "string",
"enum": [
"fr",
"en",
"zh",
"ar",
"pt",
"es"
],
"description": "Locale for returned URLs and text: fr, en, zh, ar, pt or es. Optional — detected from the query when omitted."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 20
}
},
"additionalProperties": false
}🟢recent_events(city, date, lang, limit)
List upcoming Pionra events, optionally filtered by city and date.
Input Schema
{
"type": "object",
"properties": {
"city": {
"type": "string"
},
"date": {
"type": "string",
"description": "Optional ISO date string."
},
"lang": {
"type": "string",
"enum": [
"fr",
"en",
"zh",
"ar",
"pt",
"es"
],
"description": "Locale for returned URLs and text: fr, en, zh, ar, pt or es. Optional — detected from the query when omitted."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 20
}
},
"additionalProperties": false
}🟢get_guide(id, query, lang)
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.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Optional guide public id."
},
"query": {
"type": "string",
"description": "Optional text query when the id is unknown."
},
"lang": {
"type": "string",
"enum": [
"fr",
"en",
"zh",
"ar",
"pt",
"es"
],
"description": "Locale for returned URLs and text: fr, en, zh, ar, pt or es. Optional — detected from the query when omitted."
}
},
"additionalProperties": false
}🟡publish_guide(type, category, title, bodyMarkdown, language, ...)
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.
Input Schema
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"GUIDE",
"QUESTION",
"BLOG",
"ANNONCE",
"MARCHE",
"SERVICE"
],
"description": "Post type."
},
"category": {
"type": "string",
"description": "Active Pionra category slug (must be permitted by the API key)."
},
"title": {
"type": "string",
"description": "Post title, 5–200 characters."
},
"bodyMarkdown": {
"type": "string",
"description": "Post body in Markdown, 20–20000 characters."
},
"language": {
"type": "string",
"enum": [
"fr",
"en",
"zh",
"ar",
"pt",
"es"
],
"description": "Content language."
},
"cityScope": {
"type": "string",
"description": "Optional city slug to scope the post."
},
"countryScope": {
"type": "string",
"description": "Optional ISO country code to scope the post."
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional tags."
},
"city": {
"type": "string",
"description": "Optional free-form city label for ANNONCE, MARCHE, or SERVICE posts."
},
"housing_city": {
"type": "string",
"description": "Alias for city."
},
"locationCity": {
"type": "string",
"description": "Optional location label shown on the post; defaults to city."
},
"metroStation": {
"type": "string",
"description": "Optional nearby metro or transit station."
},
"housing_metro": {
"type": "string",
"description": "Alias for metroStation."
},
"price": {
"type": "number",
"description": "Optional price amount."
},
"housing_rent": {
"type": "number",
"description": "Alias for price."
},
"priceCurrency": {
"type": "string",
"description": "Optional ISO currency code. Defaults to EUR for ANNONCE, MARCHE, and SERVICE."
},
"negotiable": {
"type": "boolean",
"description": "Optional negotiable flag for classified-style posts."
},
"expiresAt": {
"type": "string",
"description": "Optional ISO date or date-time when the post should expire."
},
"housingType": {
"type": "string",
"description": "Optional housing type, for example studio, chambre, or colocation."
},
"housingSurface": {
"type": "number",
"description": "Optional housing surface area. Stored as an integer."
},
"housingRooms": {
"type": "number",
"description": "Optional room count. Stored as an integer."
},
"housingFurnished": {
"type": "boolean",
"description": "Optional furnished flag."
},
"housingAvailableFrom": {
"type": "string",
"description": "Optional ISO date or date-time when the housing becomes available."
},
"housing_available_at": {
"type": "string",
"description": "Alias for housingAvailableFrom."
},
"housingDeposit": {
"type": "number",
"description": "Optional housing deposit amount."
},
"jobContractType": {
"type": "string",
"description": "Optional job or service contract type."
},
"jobRemote": {
"type": "string",
"description": "Optional remote mode label, for example onsite, hybrid, or remote."
},
"jobSalaryMin": {
"type": "number",
"description": "Optional minimum salary. Stored as an integer."
},
"jobSalaryMax": {
"type": "number",
"description": "Optional maximum salary. Stored as an integer."
},
"coverEmoji": {
"type": "string",
"description": "Optional cover emoji, up to 16 characters."
},
"cover_emoji": {
"type": "string",
"description": "Alias for coverEmoji."
},
"coverImageUrl": {
"type": "string",
"format": "uri",
"description": "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."
},
"cover_image_url": {
"type": "string",
"format": "uri",
"description": "Alias for coverImageUrl."
}
},
"required": [
"type",
"category",
"title",
"bodyMarkdown",
"language"
],
"additionalProperties": false
}Community
Evidence