{"openapi":"3.1.0","info":{"title":"Papeleo (Paperwork) API","version":"0.1.0","description":"A fully local Spanish civic-procedure reference: DNI/NIE explainers, the padrón municipal, the Social Security affiliation number, and general step/document/agency/time-cost guidance for common trámites (NIE, empadronamiento, tarjeta de residencia, driving-license exchange, opening a bank account, tarjeta sanitaria).\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://papeleo.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/papeleo/docs"},"termsOfService":"https://connectorbay.com/papeleo/terms"},"servers":[{"url":"https://papeleo.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/papeleo/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/dni_nie_info":{"post":{"operationId":"dni_nie_info","summary":"Explain the difference between the DNI (Documento Nacional de Identidad, for Spanish citizens) and","description":"Explain the difference between the DNI (Documento Nacional de Identidad, for Spanish citizens) and\n    the NIE (Número de Identidad de Extranjero, for foreign residents, property owners and workers) — who\n    needs which, and each one's general format. Use for \"what's the difference between DNI and NIE\",\n    \"what is a NIE\", \"do I need a DNI or a NIE\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"dni_nie_infoArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/empadronamiento_guide":{"post":{"operationId":"empadronamiento_guide","summary":"Explain the padrón municipal (town-hall residency registration) — what it's for (the main proof of","description":"Explain the padrón municipal (town-hall residency registration) — what it's for (the main proof of\n    residence in Spain, needed for many other procedures) and the general process to register. Use for\n    \"what is empadronamiento\", \"why do I need to register at the town hall\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"empadronamiento_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/seguridad_social_info":{"post":{"operationId":"seguridad_social_info","summary":"Explain the Social Security affiliation number (número de afiliación a la Seguridad Social) needed","description":"Explain the Social Security affiliation number (número de afiliación a la Seguridad Social) needed\n    to work legally in Spain, and the general process for obtaining one. Use for \"how do I get a Spanish\n    Social Security number\", \"what is número de afiliación\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"seguridad_social_infoArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/procedure_guide":{"post":{"operationId":"procedure_guide","summary":"A step-by-step overview for a common Spanish trámite — NIE application, empadronamiento, a","description":"A step-by-step overview for a common Spanish trámite — NIE application, empadronamiento, a\n    residency permit (tarjeta de residencia / TIE), exchanging a foreign driving license, opening a bank\n    account as a foreigner, or the health card (tarjeta sanitaria) — with typical required documents and\n    which agency handles it. Use for \"how do I apply for a NIE\", \"steps to get a tarjeta de residencia\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A trámite name or key.","examples":["nie","empadronamiento","tarjeta de residencia","driving license exchange","bank account","tarjeta sanitaria"],"title":"Name","type":"string"}},"required":["name"],"title":"procedure_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/document_checklist":{"post":{"operationId":"document_checklist","summary":"The typical documents needed for a given trámite, as a short checklist. Use for \"what do I need to","description":"The typical documents needed for a given trámite, as a short checklist. Use for \"what do I need to\n    bring for the NIE\", \"documents for opening a bank account in Spain\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"procedure":{"description":"A trámite name or key.","examples":["nie","empadronamiento","residencia","carnet_conducir","cuenta_bancaria","tarjeta_sanitaria"],"title":"Procedure","type":"string"}},"required":["procedure"],"title":"document_checklistArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/office_directory_hint":{"post":{"operationId":"office_directory_hint","summary":"Which agency generally handles a given trámite (Policía Nacional/Extranjería, Ayuntamiento,","description":"Which agency generally handles a given trámite (Policía Nacional/Extranjería, Ayuntamiento,\n    Tesorería General de la Seguridad Social, DGT, a private bank, or the Agencia Tributaria) and where to\n    go — informational only, not a live office directory or lookup. Use for \"who issues the NIE\",\n    \"which office handles empadronamiento\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"procedure":{"description":"A trámite name/key, or an agency name (Policia Nacional, Ayuntamiento, TGSS, DGT, Banco, Agencia Tributaria).","examples":["nie","empadronamiento","tarjeta_sanitaria","DGT"],"title":"Procedure","type":"string"}},"required":["procedure"],"title":"office_directory_hintArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/estimated_time_cost":{"post":{"operationId":"estimated_time_cost","summary":"A typical processing-time range and fee tier (free / nominal / moderate) for a trámite — heavily","description":"A typical processing-time range and fee tier (free / nominal / moderate) for a trámite — heavily\n    caveated, since exact figures change and vary by region and office. Use for \"how long does the NIE\n    take\", \"is there a fee for empadronamiento\", \"how much does the driving-license exchange cost\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"procedure":{"description":"A trámite name or key.","examples":["nie","empadronamiento","residencia","carnet_conducir","cuenta_bancaria","tarjeta_sanitaria"],"title":"Procedure","type":"string"}},"required":["procedure"],"title":"estimated_time_costArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/required_documents":{"post":{"operationId":"required_documents","summary":"A deeper look at the documents a trámite needs — each item with a note on what it's for or how to","description":"A deeper look at the documents a trámite needs — each item with a note on what it's for or how to\n    get it — plus which agency handles it and where to go. Use for \"what exactly counts as proof of\n    address for empadronamiento\", \"what document proves my entitlement route for the tarjeta sanitaria\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"procedure":{"description":"A trámite name or key.","examples":["nie","empadronamiento","residencia","carnet_conducir","cuenta_bancaria","tarjeta_sanitaria"],"title":"Procedure","type":"string"}},"required":["procedure"],"title":"required_documentsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/procedure_glossary":{"post":{"operationId":"procedure_glossary","summary":"Definitions of common Spanish civic-procedure terms (DNI, NIE, TIE, padrón, empadronamiento, cita","description":"Definitions of common Spanish civic-procedure terms (DNI, NIE, TIE, padrón, empadronamiento, cita\n    previa, tasa, Sede Electrónica, Extranjería, NIF, número de afiliación). Use for \"what does cita\n    previa mean\", \"what's a tasa\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific term to look up; omit to list all.","title":"Term"}},"title":"procedure_glossaryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}