Política Electoral — MCP Server

API de datos electorales del mundo democrático: partidos políticos, perfiles ideológicos y programas electorales. Disponible como servidor MCP (Model Context Protocol) sobre HTTP para integraciones con agentes IA.

---

Endpoints

URL	Descripción
POST /mcp-server	Endpoint principal JSON-RPC 2.0
GET /mcp-server	Información del servidor
GET /.well-known/mcp.json	Descubrimiento automático (MCP discovery)
GET /llms.txt	Índice de contenido para LLMs

---

Protocolo

El servidor implementa MCP 2024-11-05 sobre HTTP (JSON-RPC 2.0).

Request mínimo:

POST /mcp-server
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_parties_list",
    "arguments": { "country": "es" }
  }
}

Handshake completo:

# 1. Initialize
curl -X POST https://www.politicaelectoral.com/mcp-server \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"my-client","version":"1.0"}}}'

# 2. Notificar que está listo (no espera respuesta)
curl -X POST https://www.politicaelectoral.com/mcp-server \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"notifications/initialized","params":{}}'

# 3. Usar tools
curl -X POST https://www.politicaelectoral.com/mcp-server \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

---

Países disponibles

Slug	Código ISO	País
espana	es	España
argentina	ar	Argentina
francia	fr	Francia
alemania	de	Alemania
italia	it	Italia
portugal	pt	Portugal
reino-unido	gb	Reino Unido
polonia	pl	Polonia
hungria	hu	Hungría
mexico	mx	México
chile	cl	Chile
colombia	co	Colombia
uruguay	uy	Uruguay
peru	pe	Perú
eeuu	us	Estados Unidos
europa	eu	Unión Europea

El parámetro country acepta tanto el slug (espana) como el código ISO (es).

---

Tools

get_parties_list

Lista todos los partidos políticos de un país.

Parámetros:

Nombre	Tipo	Requerido	Descripción
country	string	sí	Código ISO o slug del país

Ejemplo:

{
  "name": "get_parties_list",
  "arguments": { "country": "es" }
}

---

get_party_profile

Perfil ideológico e histórico de un partido político. Devuelve un documento Markdown con historia, posicionamiento ideológico y trayectoria electoral.

Parámetros:

Nombre	Tipo	Requerido	Descripción
country	string	sí	Código ISO o slug del país
party	string	sí	Slug del partido (e.g. pp, psoe, vox)

Ejemplo:

{
  "name": "get_party_profile",
  "arguments": { "country": "es", "party": "psoe" }
}

---

get_elections_list

Lista todas las elecciones disponibles para un país, con tipo y fecha.

Parámetros:

Nombre	Tipo	Requerido	Descripción
country	string	sí	Código ISO o slug del país

Ejemplo:

{
  "name": "get_elections_list",
  "arguments": { "country": "es" }
}

---

get_election_regions

Lista las regiones disponibles para una elección concreta (comunidades autónomas, estados, etc.).

Parámetros:

Nombre	Tipo	Requerido	Descripción
country	string	sí	Código ISO o slug del país
election	string	sí	Slug de la elección (e.g. generales-2023, autonomicas-2024)

Ejemplo:

{
  "name": "get_election_regions",
  "arguments": { "country": "es", "election": "generales-2023" }
}

---

get_election_region

Contenido de la landing de una elección en una región concreta: contexto, partidos participantes y datos clave.

Parámetros:

Nombre	Tipo	Requerido	Descripción
country	string	sí	Código ISO o slug del país
election	string	sí	Slug de la elección
region	string	sí	Slug de la región (e.g. nacional, cataluna, madrid)

Ejemplo:

{
  "name": "get_election_region",
  "arguments": { "country": "es", "election": "generales-2023", "region": "nacional" }
}

---

get_election_region_parties

Lista los partidos que tienen contenido electoral disponible para una elección y región concretas.

Parámetros:

Nombre	Tipo	Requerido	Descripción
country	string	sí	Código ISO o slug del país
election	string	sí	Slug de la elección
region	string	sí	Slug de la región

Ejemplo:

{
  "name": "get_election_region_parties",
  "arguments": { "country": "es", "election": "generales-2023", "region": "nacional" }
}

---

get_election_region_party

Resumen del programa electoral de un partido para una elección y región concretas. Devuelve un documento Markdown con las propuestas principales.

Parámetros:

Nombre	Tipo	Requerido	Descripción
country	string	sí	Código ISO o slug del país
election	string	sí	Slug de la elección
region	string	sí	Slug de la región
party	string	sí	Slug del partido

Ejemplo:

{
  "name": "get_election_region_party",
  "arguments": {
    "country": "es",
    "election": "generales-2023",
    "region": "nacional",
    "party": "pp"
  }
}

---

Flujo recomendado

Para obtener el programa electoral de un partido en unas elecciones:

get_elections_list(country)
  → elige election slug

get_election_regions(country, election)
  → elige region slug

get_election_region_parties(country, election, region)
  → elige party slug

get_election_region_party(country, election, region, party)
  → programa electoral en Markdown

Para obtener el perfil de un partido:

get_parties_list(country)
  → elige party slug

get_party_profile(country, party)
  → perfil ideológico en Markdown

---

Recursos adicionales en Markdown

Las páginas del sitio se pueden consultar directamente en formato Markdown añadiendo .md a la URL:

/es/{pais}/partido/{slug}.md               → perfil del partido
/es/{pais}/{eleccion}/{region}.md          → landing elección+región
/es/{pais}/{eleccion}/{region}/{partido}.md → resumen del partido
/es/blog/{slug}.md                         → artículo del blog

---

Licencia y uso

Los datos provienen de los programas electorales oficiales de cada partido. El contenido de los perfiles y análisis ha sido generado con IA a partir de fuentes públicas. Uso libre para proyectos no comerciales con atribución.

Sitio web: politicaelectoral.com