API reference

Every operation of Emporium's HTTP API, generated from the contract: what it does, how to call it and where to reach it.

The operations

84 operations, in the contract's order. Each one leads to its reference page.

  1. GET /

    get_front_page

    The front page in English: HTML for people, with the motto, For developers (/developers), For agents (/llms.txt), Privacy and the EN | ES switch; with Accept: text/markdown, the body of /index.md

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  2. GET /.well-known/agent-card.json

    get_agent_card

    The A2A card: it speaks MCP, not A2A

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  3. GET /.well-known/agent-skills/emporium-business-diagnosis/SKILL.md

    get_business_diagnosis_skill

    The business diagnosis skill: measure a business, match it against the offer, the shortest path and the demand

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  4. GET /.well-known/agent-skills/index.json

    get_agent_skills_index

    The skills index: /skill.md with its sha256

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  5. GET /.well-known/agent.json

    get_agent_json

    The A2A card at its old location

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  6. GET /.well-known/api-catalog

    get_api_catalog

    The API catalog, RFC 9727

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  7. GET /.well-known/mcp/server-card.json

    get_mcp_server_card

    The MCP server card

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  8. GET /api/businesses

    list_businesses

    Lists the businesses

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  9. POST /api/businesses

    create_business

    Creates a business draft

    API Live MCP Coming soon SDK Coming soon CLI Coming soon

  10. GET /api/businesses/{slug}

    get_business

    One business

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  11. GET /api/businesses/{slug}/artifacts

    get_business_artifacts

    The artifacts a business installs on its own domain, with its key

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  12. POST /api/businesses/{slug}/channel/resend-confirmation

    resend_channel_confirmation

    Resends the channel confirmation

    API Live MCP Coming soon SDK Coming soon CLI Coming soon

  13. GET /api/businesses/{slug}/diagnosis

    get_business_diagnosis

    The business's diagnosis and plan, with its key; never public

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  14. PUT /api/businesses/{slug}/diagnosis

    deliver_business_diagnosis

    Swarm only, signed: delivers the measured draft against a pending request

    API Live MCP Coming soon SDK Coming soon CLI Coming soon

  15. POST /api/businesses/{slug}/diagnosis/request

    request_business_diagnosis

    Requests the business's diagnosis from the swarm, with its key

    API Live MCP Coming soon SDK Coming soon CLI Coming soon

  16. GET /api/businesses/{slug}/kit

    get_business_kit

    The business's kit to give to its agent: an AGENTS.md with the steps to sell and the check for each one, with its key

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  17. GET /api/businesses/{slug}/log

    get_business_log

    A business log, read only

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  18. PUT /api/businesses/{slug}/manifest

    put_business_manifest

    Changes a business manifest

    API Live MCP Coming soon SDK Coming soon CLI Coming soon

  19. POST /api/businesses/{slug}/plan

    create_business_plan

    A business's integration plan, with its key

    API Live MCP Coming soon SDK Coming soon CLI Coming soon

  20. GET /api/businesses/{slug}/preview

    preview_business

    How a business's public side will look, before publishing

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  21. POST /api/businesses/{slug}/publish

    publish_business

    Publishes a business

    API Live MCP Coming soon SDK Coming soon CLI Coming soon

  22. GET /api/businesses/{slug}/quotes

    list_quotes

    Lists a business's quotes, redacted

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  23. POST /api/businesses/{slug}/quotes

    request_quote

    Requests a quote from a business, no credential; with `datos`, the data the offer's contract asks for, and 422 `faltan_datos` if one needed to quote is missing

    API Live MCP Live SDK Coming soon CLI Coming soon

  24. GET /api/businesses/{slug}/quotes/{quote_id}

    get_quote

    One quote, for the agent who asked for it, with the payment block

    API Read-only MCP Read-only SDK Coming soon CLI Coming soon

  25. POST /api/businesses/{slug}/quotes/{quote_id}/accept

    accept_quote

    The requester accepts what the business stated

    API Live MCP Coming soon SDK Coming soon CLI Coming soon

  26. POST /api/businesses/{slug}/quotes/{quote_id}/confirm

    confirm_quote

    The business confirms what was paid

    API Live MCP Coming soon SDK Coming soon CLI Coming soon

  27. POST /api/businesses/{slug}/quotes/{quote_id}/mark-paid

    state_quote_paid

    The business states it was paid; Emporium does not verify it

    API Live MCP Coming soon SDK Coming soon CLI Coming soon

  28. POST /api/businesses/{slug}/terms

    accept_terms

    Accepts the terms

    API Live MCP Coming soon SDK Coming soon CLI Coming soon

  29. POST /api/businesses/{slug}/unpublish

    unpublish_business

    Unpublishes a business

    API Live MCP Coming soon SDK Coming soon CLI Coming soon

  30. GET /api/businesses/{slug}/use-cases

    get_business_use_cases

    A published business's use cases and the gaps it closes, by category

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  31. POST /api/businesses/{slug}/verification/checks

    read_domain_proof

    Reads the domain proof

    API Live MCP Coming soon SDK Coming soon CLI Coming soon

  32. POST /api/businesses/{slug}/verification/token

    renew_verification_token

    Requests a new verification token

    API Live MCP Coming soon SDK Coming soon CLI Coming soon

  33. GET /api/channel/confirm/{token}

    confirm_channel

    Confirms the channel with a single-use link

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  34. GET /api/configuration

    get_configuration

    What this deployment has configured: booleans and enums only

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  35. GET /api/directory

    search_directory

    Searches the guide for a service; what you search for is stored privately to improve the engine (what is stored and for how long: /privacy?idioma=en)

    API Read-only MCP Read-only SDK Coming soon CLI Read-only

  36. GET /api/directory/categories

    list_directory_by_category

    The yellow pages, by category: every registered business and every admitted pay-per-use API, with how to call it; registered businesses first

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  37. GET /api/flow

    get_flow

    The aggregated flow record

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  38. GET /api/flow/chart.svg

    get_flow_chart

    The river chart, as SVG

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  39. GET /api/offer

    get_offer

    The offer by purpose, generated from the catalog: each capability with its business patterns, its state and its tools

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  40. GET /api/swarm/requests

    list_pending_diagnoses

    Swarm only, signed: the pending diagnosis requests (slug, domain and date)

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  41. GET /api/wallet/onboarding

    get_wallet_onboarding

    How to get your agent a wallet with PayBox, the default non-custodial wallet: the four steps, and PayBox's MCP, CLI and TypeScript SDK with what to copy, in English or in Spanish. The same guide as emporium_wallet_onboarding

    API Read-only MCP Read-only SDK Coming soon CLI Read-only

  42. GET /auth.md

    get_auth_md

    Who Emporium authenticates: people who sign in with PayBox, on the website and to use the MCP (OAuth 2.1)

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  43. POST /counter/mcp

    call_counter_mcp

    The counter: the read-only tools of the house's surfaces, forwarded, and the house combos

    API Live MCP Coming soon SDK Coming soon CLI Coming soon

  44. GET /developers

    get_developers_page

    The page for developers in English, generated from the catalog and the contract: the blocks with the state of their API, MCP, SDK and CLI, the same call four ways, the kits, the rules and everything in the contract

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  45. GET /directory

    get_directory_page

    The catalog for builders: what each entry does, its protocol, its seller's asking price and its entry point

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  46. GET /directory/categories

    get_directory_categories_page

    The catalog by category, for whoever looks for a service: the same entries as the search, grouped

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  47. GET /directory/categories/en

    get_directory_categories_page_en

    The catalog by category, in English

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  48. GET /directory/en

    get_directory_page_en

    The catalog, in English

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  49. GET /docs

    get_api_reference

    The API reference for people in English, generated from the contract: every operation with its method, its path, what it does and its state in API, MCP, SDK and CLI

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  50. GET /docs/{operation_id}

    get_operation_reference

    The reference page of one operation in English, by its operationId: where to reach it, its parameters, its body, its responses and the schemas it names

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  51. GET /es

    get_front_page_es

    The front page in Spanish: the same as /, in Spanish; with Accept: text/markdown, the body of /index.md

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  52. GET /es/developers

    get_developers_page_es

    The page for developers in Spanish: the same as /developers, in Spanish

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  53. GET /es/docs

    get_api_reference_es

    The API reference, in Spanish

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  54. GET /es/docs/{operation_id}

    get_operation_reference_es

    The reference page of one operation, in Spanish

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  55. GET /flow

    get_flow_page

    The river: what was asked for and what answered

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  56. GET /health

    get_health

    Service health, no I/O

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  57. GET /index.md

    get_index_md

    The front page for an agent, in Markdown

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  58. GET /llms-full.txt

    get_llms_full_txt

    Every document for agents, in one

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  59. GET /llms.txt

    get_llms_txt

    What Emporium is, for an agent

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  60. POST /mcp

    call_mcp

    Emporium's MCP, with an OAuth 2.1 token from Emporium (sign in with PayBox): the six house tools, the three for a business by its slug and the person's wallets, read-only

    API Live MCP Coming soon SDK Coming soon CLI Coming soon

  61. GET /n/{slug}

    get_business_profile

    A business's public profile

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  62. GET /n/{slug}/en

    get_business_profile_en

    A business's public profile, in English

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  63. GET /n/{slug}/manifest.json

    get_business_manifest

    A business's public manifest

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  64. POST /n/{slug}/mcp

    call_business_mcp

    The MCP of a published business, at `<EMPORIUM_BASE_URL>/n/<slug>/mcp` with the `slug` that `emporium_search_service` gives: JSON-RPC 2.0 like `/mcp`, with no credential and with the header `Accept: application/json, text/event-stream`; `{"jsonrpc":"2.0","id":1,"method":"tools/list"}` lists its three tools, `<slug>_ficha`, `<slug>_catalogo` and `<slug>_pedir_cotizacion` (each `-` of the slug written `_`)

    API Live MCP Coming soon SDK Coming soon CLI Coming soon

  65. GET /n/{slug}/offers/{offer_id}/slots

    get_offer_slots

    The free time slots of a bookable offer, with active holds respected

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  66. GET /openapi.json

    get_openapi

    This document

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  67. GET /privacy

    get_privacy_page

    What Emporium keeps from each search in the guide, for how long and who reads it

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  68. GET /r/{token}

    get_quote_reply_form

    The business's reply form; does not consume the link

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  69. POST /r/{token}

    reply_to_quote

    The business replies and consumes the link

    API Live MCP Coming soon SDK Coming soon CLI Coming soon

  70. GET /robots.txt

    get_robots_txt

    What a crawler may read

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  71. GET /signup

    get_signup_page

    Add your business: paste your domain, request your diagnosis and see it, without JSON or JavaScript

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  72. POST /signup

    submit_signup_form

    The page's form: creates the draft and shows the key once

    API Live MCP Coming soon SDK Coming soon CLI Coming soon

  73. GET /signup/en

    get_signup_page_en

    The same page, in English

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  74. POST /signup/kit

    submit_kit_download_form

    The page's form: downloads the kit, with slug and key

    API Live MCP Coming soon SDK Coming soon CLI Coming soon

  75. POST /signup/publish

    submit_publish_form

    The page's form: publishes the business, with slug and key

    API Live MCP Coming soon SDK Coming soon CLI Coming soon

  76. POST /signup/request

    submit_diagnosis_request_form

    The page's form: the diagnosis request

    API Live MCP Coming soon SDK Coming soon CLI Coming soon

  77. POST /signup/status

    submit_diagnosis_status_form

    The page's form: the diagnosis report, with slug and key

    API Live MCP Coming soon SDK Coming soon CLI Coming soon

  78. POST /signup/terms

    submit_terms_form

    The page's form: accepts the current terms, with slug, key and the box ticked

    API Live MCP Coming soon SDK Coming soon CLI Coming soon

  79. POST /signup/verification/checks

    submit_domain_check_form

    The page's form: reads the domain proof, with slug and key

    API Live MCP Coming soon SDK Coming soon CLI Coming soon

  80. POST /signup/verification/token

    submit_new_token_form

    The page's form: a new verification token, with slug and key

    API Live MCP Coming soon SDK Coming soon CLI Coming soon

  81. GET /sitemap.xml

    get_sitemap

    The public pages and documents

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  82. GET /skill.md

    get_skill_md

    The manual for an agent: the flows and the errors

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

  83. GET /terms/{version}

    get_terms

    The text of a terms version

    API Read-only MCP Coming soon SDK Coming soon CLI Coming soon

Live: you can use it today, to read and to write. Read-only: today you can read, not write. Coming soon: not there yet.

The house tools with no twin HTTP route have no page here: the developers page lists them, with the reason, and so do /llms.txt and the tools/list of each MCP.

The same, for a machine