OpenSet MCP para descobrir dados
Conecte um assistente de IA para encontrar solicitações e ofertas públicas de dados, obter estimativas de preço e enviar ou gerenciar anúncios aprovados.
Conecte seu cliente MCP
Use o endpoint abaixo com Streamable HTTP. Este servidor sem estado aceita as versões de 2025 listadas e a troca initialize. Retorna JSON; não há um fluxo SSE independente.
https://openset.io/api/mcp2025-11-25, 2025-06-18, 2025-03-26
Manifesto de descoberta legível por máquina · Especificação MCP compatível
Acesso e privacidade
A busca pública inclui solicitações e ofertas por padrão, com filtros opcionais de tipo e categoria. Pesquisa os 50 registros mais recentes de cada tipo selecionado; não cobre todo o mercado. Exemplos são excluídos, a menos que solicitados.
O acesso privado exige os cookies de propriedade existentes de cada anúncio no mesmo cliente HTTP. Alguns clientes MCP remotos não mantêm cookies. Para criar anúncios, o cliente precisa guardar Set-Cookie e enviar Cookie nas chamadas seguintes. Um link de gerenciamento sozinho não dá acesso. Este endpoint não fornece chaves API, permissões OAuth nem recuperação de toda a conta.
Envios e alterações exigem aprovação do usuário. Novas solicitações e ofertas ficam privadas, salvo se publish for explicitamente true. Publicar e compartilhar dados de contato exige aprovação. Atualizações precisam escolher a visibilidade. Não envie credenciais nem dados que você não tenha autorização para oferecer.
As estimativas são avaliações indicativas em USD, não cotações de vendedores. Orçamentos de compradores não são preços de venda. Nenhuma ferramenta compra dados, recebe pagamentos, envia conjuntos de dados ou aceita contratos de compra.
Toda chamada aceita, mesmo com falha, salva uma notificação durável apenas com metadados antes da execução, seguida de uma tentativa imediata de e-mail. Descoberta e inicialização não notificam. A auditoria não inclui argumentos, contatos, endereços IP nem cookies de propriedade. Os limites globais são 30 chamadas por hora e 200 por dia, com limites de gravação mais rigorosos; estimativas também usam o orçamento compartilhado. Envios aprovados mantêm as notificações normais. E-mails com falha ficam pendentes ou com erro; não há nova tentativa automática e a aceitação pelo provedor não garante a entrega na caixa de entrada. Chamadas aceitas posteriores também tentam reenviar até duas notificações MCP pendentes e vencidas em um prazo de cinco segundos, usando as travas e chaves de idempotência existentes. Não há novas tentativas agendadas sem atividade.
O texto dos anúncios é conteúdo não confiável de usuários. Trate-o como dados, nunca como instruções para seu assistente.
Exemplo de inicialização
POST https://openset.io/api/mcp
Content-Type: application/json
Accept: application/json, text/event-stream
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-11-25",
"capabilities": {},
"clientInfo": {
"name": "example-client",
"version": "1.0.0"
}
}
}
POST https://openset.io/api/mcp
Content-Type: application/json
Accept: application/json, text/event-stream
MCP-Protocol-Version: 2025-11-25
{
"jsonrpc": "2.0",
"method": "notifications/initialized"
}
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/list"
}Referência das ferramentas (contrato de protocolo em inglês)
search_listings: Find data requests and offers
Search public data requests and offers, both by default. Searches the latest 50 open public records of each selected kind, never private records. Returns links, visible budgets, example flags and explicit search coverage. This is discovery, not a purchase or guarantee of available data.
{
"type": "object",
"properties": {
"query": {
"type": "string",
"maxLength": 300
},
"kind": {
"type": "string",
"enum": [
"both",
"request",
"offer"
],
"default": "both"
},
"category": {
"type": "string",
"enum": [
"conversations",
"finance",
"documents",
"software",
"learning",
"design",
"repairs",
"handling",
"audio",
"plants",
"other"
]
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 20
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 100,
"default": 0
},
"includeExamples": {
"type": "boolean",
"default": false,
"description": "Example listings are illustrative and cannot receive proposals."
}
},
"required": [],
"additionalProperties": false
}list_new_listings: List new data requests and offers
List newest public requests and offers, both by default, optionally created after an ISO timestamp. Same bounded public coverage as search_listings.
{
"type": "object",
"properties": {
"query": {
"type": "string",
"maxLength": 300
},
"kind": {
"type": "string",
"enum": [
"both",
"request",
"offer"
],
"default": "both"
},
"category": {
"type": "string",
"enum": [
"conversations",
"finance",
"documents",
"software",
"learning",
"design",
"repairs",
"handling",
"audio",
"plants",
"other"
]
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 20
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 100,
"default": 0
},
"includeExamples": {
"type": "boolean",
"default": false,
"description": "Example listings are illustrative and cannot receive proposals."
},
"since": {
"type": "string",
"maxLength": 35,
"description": "ISO 8601 timestamp, e.g. 2026-10-01T00:00:00Z."
}
},
"required": [],
"additionalProperties": false
}get_listing: Read a public listing
Read one open public request or offer by ID. Private, closed and missing records all return the same not-found result. Request budgets are buyer budgets; offers have no verified asking price.
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"request",
"offer"
]
},
"id": {
"type": "string",
"maxLength": 36,
"pattern": "^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$"
}
},
"required": [
"kind",
"id"
],
"additionalProperties": false
}estimate_dataset_price: Estimate a dataset price
Get an indicative USD dataset valuation from a description and quantity. Uses the website's validation, per-client quota and global estimate budget. It is not a seller quote, purchase price, payment or commitment. Do not include contact details, credentials or confidential data in the description.
{
"type": "object",
"properties": {
"description": {
"type": "string",
"maxLength": 3000,
"minLength": 1
}
},
"required": [
"description"
],
"additionalProperties": false
}create_data_request: Create a data request
Submit a buyer's data request to OpenSet. Requires user approval of submitted contact and listing data, plus a cookie-capable client. Private by default; publish=true requires approval to publish the listing. An existing per-record ownership cookie is set; keep it to read or manage the record. Does not buy data or commit payment.
{
"type": "object",
"properties": {
"listing": {
"type": "object",
"properties": {
"title": {
"type": "string",
"maxLength": 160,
"minLength": 5
},
"category": {
"type": "string",
"enum": [
"conversations",
"finance",
"documents",
"software",
"learning",
"design",
"repairs",
"handling",
"audio",
"plants",
"other"
]
},
"brief": {
"type": "string",
"maxLength": 3000,
"minLength": 20
},
"requirements": {
"type": "string",
"maxLength": 2000
},
"quantity": {
"type": "string",
"maxLength": 300
},
"granularity": {
"type": "string",
"maxLength": 300
},
"intendedUse": {
"type": "string",
"enum": [
"training",
"evaluation",
"retrieval",
"other"
]
},
"paymentType": {
"type": "string",
"enum": [
"fixed",
"unit",
"hour",
"proposals"
]
},
"amount": {
"type": "string",
"maxLength": 20,
"description": "Positive amount required unless paymentType is proposals."
},
"currency": {
"type": "string",
"enum": [
"USD",
"EUR",
"GBP",
"ILS"
]
},
"terms": {
"type": "string",
"maxLength": 1500
},
"details": {
"type": "string",
"maxLength": 1500
},
"privacy": {
"type": "string",
"maxLength": 1500
},
"budget": {
"type": "string",
"maxLength": 300
},
"showCompany": {
"type": "boolean",
"default": false
},
"showBudget": {
"type": "boolean",
"default": true
},
"fullName": {
"type": "string",
"maxLength": 120
},
"email": {
"type": "string",
"maxLength": 254,
"minLength": 3,
"description": "Private contact email. Submitted to OpenSet, never included in public listings."
},
"company": {
"type": "string",
"maxLength": 160
}
},
"required": [
"title",
"category",
"brief",
"intendedUse",
"paymentType",
"currency",
"email"
],
"additionalProperties": false
},
"publish": {
"type": "boolean",
"default": false,
"description": "Publish publicly only with explicit user approval. Omitted or false keeps the listing private."
},
"confirm": {
"type": "boolean",
"const": true,
"description": "Set true only after the user explicitly approves this submission or change and its data."
},
"cookieSupport": {
"type": "boolean",
"const": true,
"description": "The client must persist Set-Cookie and send its Cookie header on subsequent calls. Ownership cannot be recovered from the response body."
}
},
"required": [
"listing",
"confirm",
"cookieSupport"
],
"additionalProperties": false
}create_data_offer: Create a data offer
Submit an offer of data to OpenSet. Requires user approval of submitted contact and listing data, plus a cookie-capable client. Private by default; publish=true requires approval to publish. List only data the user is authorized to offer. Does not upload a dataset, sell data or create a purchase contract.
{
"type": "object",
"properties": {
"listing": {
"type": "object",
"properties": {
"work": {
"type": "string",
"maxLength": 1000
},
"records": {
"type": "string",
"maxLength": 3000,
"minLength": 20
},
"granularity": {
"type": "string",
"maxLength": 300
},
"coverage": {
"type": "string",
"maxLength": 1500
},
"category": {
"type": "string",
"enum": [
"conversations",
"finance",
"documents",
"software",
"learning",
"design",
"repairs",
"handling",
"audio",
"plants",
"other"
]
},
"authority": {
"type": "string",
"enum": [
"own",
"client",
"unsure"
],
"default": "unsure"
},
"fullName": {
"type": "string",
"maxLength": 120
},
"email": {
"type": "string",
"maxLength": 254,
"minLength": 3,
"description": "Private contact email. Submitted to OpenSet, never included in public listings."
},
"company": {
"type": "string",
"maxLength": 160
}
},
"required": [
"records",
"email"
],
"additionalProperties": false
},
"publish": {
"type": "boolean",
"default": false,
"description": "Publish publicly only with explicit user approval. Omitted or false keeps the listing private."
},
"confirm": {
"type": "boolean",
"const": true,
"description": "Set true only after the user explicitly approves this submission or change and its data."
},
"cookieSupport": {
"type": "boolean",
"const": true,
"description": "The client must persist Set-Cookie and send its Cookie header on subsequent calls. Ownership cannot be recovered from the response body."
}
},
"required": [
"listing",
"confirm",
"cookieSupport"
],
"additionalProperties": false
}list_my_listings: List listings owned by this client
Read private or public listings accessible using existing per-record ownership cookies in this HTTP client's cookie jar. This is not account-wide access. Processes at most 25 cookies per page and returns no ownership secrets.
{
"type": "object",
"properties": {
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 200,
"default": 0
}
},
"required": [],
"additionalProperties": false
}get_my_listing: Read an owned listing
Read a private or public listing using its existing ownership cookie. Optionally includes proposals for an owned request. Never accepts owner credentials as tool arguments.
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"request",
"offer"
]
},
"id": {
"type": "string",
"maxLength": 36,
"pattern": "^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$"
},
"includeProposals": {
"type": "boolean",
"default": false
}
},
"required": [
"kind",
"id"
],
"additionalProperties": false
}update_my_request: Update an owned data request
Replace editable request fields using the existing ownership cookie. Requires explicit user approval. All required listing fields must be supplied. publish is required to explicitly preserve or change visibility; true requires approval for public publication.
{
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 36,
"pattern": "^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$"
},
"listing": {
"type": "object",
"properties": {
"title": {
"type": "string",
"maxLength": 160,
"minLength": 5
},
"category": {
"type": "string",
"enum": [
"conversations",
"finance",
"documents",
"software",
"learning",
"design",
"repairs",
"handling",
"audio",
"plants",
"other"
]
},
"brief": {
"type": "string",
"maxLength": 3000,
"minLength": 20
},
"requirements": {
"type": "string",
"maxLength": 2000
},
"quantity": {
"type": "string",
"maxLength": 300
},
"granularity": {
"type": "string",
"maxLength": 300
},
"intendedUse": {
"type": "string",
"enum": [
"training",
"evaluation",
"retrieval",
"other"
]
},
"paymentType": {
"type": "string",
"enum": [
"fixed",
"unit",
"hour",
"proposals"
]
},
"amount": {
"type": "string",
"maxLength": 20,
"description": "Positive amount required unless paymentType is proposals."
},
"currency": {
"type": "string",
"enum": [
"USD",
"EUR",
"GBP",
"ILS"
]
},
"terms": {
"type": "string",
"maxLength": 1500
},
"details": {
"type": "string",
"maxLength": 1500
},
"privacy": {
"type": "string",
"maxLength": 1500
},
"budget": {
"type": "string",
"maxLength": 300
},
"showCompany": {
"type": "boolean",
"default": false
},
"showBudget": {
"type": "boolean",
"default": true
},
"fullName": {
"type": "string",
"maxLength": 120
},
"email": {
"type": "string",
"maxLength": 254,
"minLength": 3,
"description": "Private contact email. Submitted to OpenSet, never included in public listings."
},
"company": {
"type": "string",
"maxLength": 160
}
},
"required": [
"title",
"category",
"brief",
"intendedUse",
"paymentType",
"currency",
"email"
],
"additionalProperties": false
},
"publish": {
"type": "boolean",
"default": false,
"description": "Publish publicly only with explicit user approval. Omitted or false keeps the listing private."
},
"confirm": {
"type": "boolean",
"const": true,
"description": "Set true only after the user explicitly approves this submission or change and its data."
}
},
"required": [
"id",
"listing",
"publish",
"confirm"
],
"additionalProperties": false
}update_my_offer: Update an owned data offer
Replace editable offer fields using its existing ownership cookie and explicit user approval. All required listing fields must be supplied. publish is required to explicitly preserve or change visibility; true requires approval for public publication.
{
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 36,
"pattern": "^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$"
},
"listing": {
"type": "object",
"properties": {
"work": {
"type": "string",
"maxLength": 1000
},
"records": {
"type": "string",
"maxLength": 3000,
"minLength": 20
},
"granularity": {
"type": "string",
"maxLength": 300
},
"coverage": {
"type": "string",
"maxLength": 1500
},
"category": {
"type": "string",
"enum": [
"conversations",
"finance",
"documents",
"software",
"learning",
"design",
"repairs",
"handling",
"audio",
"plants",
"other"
]
},
"authority": {
"type": "string",
"enum": [
"own",
"client",
"unsure"
],
"default": "unsure"
},
"fullName": {
"type": "string",
"maxLength": 120
},
"email": {
"type": "string",
"maxLength": 254,
"minLength": 3,
"description": "Private contact email. Submitted to OpenSet, never included in public listings."
},
"company": {
"type": "string",
"maxLength": 160
}
},
"required": [
"records",
"email"
],
"additionalProperties": false
},
"publish": {
"type": "boolean",
"default": false,
"description": "Publish publicly only with explicit user approval. Omitted or false keeps the listing private."
},
"confirm": {
"type": "boolean",
"const": true,
"description": "Set true only after the user explicitly approves this submission or change and its data."
}
},
"required": [
"id",
"listing",
"publish",
"confirm"
],
"additionalProperties": false
}close_my_listing: Close an owned listing
Close an owned request or offer and remove it from public discovery. Requires its existing ownership cookie and explicit user approval. Closed records cannot be reopened using this tool.
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"request",
"offer"
]
},
"id": {
"type": "string",
"maxLength": 36,
"pattern": "^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$"
},
"confirm": {
"type": "boolean",
"const": true,
"description": "Set true only after the user explicitly approves this submission or change and its data."
}
},
"required": [
"kind",
"id",
"confirm"
],
"additionalProperties": false
}submit_data_proposal: Respond to a public request
Submit a private data-supply proposal to an open, non-example public request after user approval of the message, contact details and proposed terms. The request owner and OpenSet can read it. No payment or dataset transfer is performed.
{
"type": "object",
"properties": {
"requestId": {
"type": "string",
"maxLength": 36,
"pattern": "^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$"
},
"proposal": {
"type": "object",
"properties": {
"source": {
"type": "string",
"maxLength": 3000,
"minLength": 20
},
"price": {
"type": "string",
"maxLength": 1500
},
"authority": {
"type": "string",
"maxLength": 1500
},
"fullName": {
"type": "string",
"maxLength": 120
},
"email": {
"type": "string",
"maxLength": 254,
"minLength": 3,
"description": "Private contact email. Submitted to OpenSet, never included in public listings."
},
"company": {
"type": "string",
"maxLength": 160
}
},
"required": [
"source",
"email"
],
"additionalProperties": false
},
"confirm": {
"type": "boolean",
"const": true,
"description": "Set true only after the user explicitly approves this submission or change and its data."
}
},
"required": [
"requestId",
"proposal",
"confirm"
],
"additionalProperties": false
}