search_pionra

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

Parameters4

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

Raw 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

List Pionra country communities that match a query.

Parameters3

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

Raw 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

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

Parameters3

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

Raw 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

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

Parameters5

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

Raw 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

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

Parameters5

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

Raw 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

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

Parameters4

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

Raw 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

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.

Parameters3

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

Raw 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

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.

Parameters33

type	string	required	Post type.
category	string	required	Active Pionra category slug (must be permitted by the API key).
title	string	required	Post title, 5–200 characters.
bodyMarkdown	string	required	Post body in Markdown, 20–20000 characters.
language	string	required	Content language.
cityScope	string	optional	Optional city slug to scope the post.
countryScope	string	optional	Optional ISO country code to scope the post.
tags	array	optional	Optional tags.
city	string	optional	Optional free-form city label for ANNONCE, MARCHE, or SERVICE posts.
housing_city	string	optional	Alias for city.
locationCity	string	optional	Optional location label shown on the post; defaults to city.
metroStation	string	optional	Optional nearby metro or transit station.
housing_metro	string	optional	Alias for metroStation.
price	number	optional	Optional price amount.
housing_rent	number	optional	Alias for price.
priceCurrency	string	optional	Optional ISO currency code. Defaults to EUR for ANNONCE, MARCHE, and SERVICE.
negotiable	boolean	optional	Optional negotiable flag for classified-style posts.
expiresAt	string	optional	Optional ISO date or date-time when the post should expire.
housingType	string	optional	Optional housing type, for example studio, chambre, or colocation.
housingSurface	number	optional	Optional housing surface area. Stored as an integer.
housingRooms	number	optional	Optional room count. Stored as an integer.
housingFurnished	boolean	optional	Optional furnished flag.
housingAvailableFrom	string	optional	Optional ISO date or date-time when the housing becomes available.
housing_available_at	string	optional	Alias for housingAvailableFrom.
housingDeposit	number	optional	Optional housing deposit amount.
jobContractType	string	optional	Optional job or service contract type.
jobRemote	string	optional	Optional remote mode label, for example onsite, hybrid, or remote.
jobSalaryMin	number	optional	Optional minimum salary. Stored as an integer.
jobSalaryMax	number	optional	Optional maximum salary. Stored as an integer.
coverEmoji	string	optional	Optional cover emoji, up to 16 characters.
cover_emoji	string	optional	Alias for coverEmoji.
coverImageUrl	string	optional	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	string	optional	Alias for coverImageUrl.

Raw 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
}

Pionra

MCP Server: world.pionra/pionra

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

search_pionra

list_communities

get_community

find_housing

find_jobs

recent_events

get_guide

publish_guide

Install

Remote endpoint

Related servers