OpenSet MCP für die Datensuche
Verbinden Sie einen KI-Assistenten, um öffentliche Datengesuche und Angebote zu finden, unverbindliche Preisschätzungen zu erhalten und genehmigte Einträge einzureichen oder zu verwalten.
MCP-Client verbinden
Verwenden Sie den folgenden Endpunkt mit Streamable HTTP. Der zustandslose Server unterstützt die aufgeführten Protokollversionen von 2025 mit initialize-Handshake. Antworten sind JSON; ein eigenständiger SSE-Stream ist nicht verfügbar.
https://openset.io/api/mcp2025-11-25, 2025-06-18, 2025-03-26
Maschinenlesbares Discovery-Manifest · Unterstützte MCP-Spezifikation
Zugriff und Datenschutz
Die öffentliche Suche umfasst standardmäßig Gesuche und Angebote, mit optionalen Typ- und Kategoriefiltern. Durchsucht werden die neuesten 50 Datensätze je ausgewähltem Typ, nicht der gesamte Marktplatz. Beispiele werden nur auf Wunsch einbezogen.
Private Einträge sind nur über die vorhandenen Eigentümer-Cookies des jeweiligen Eintrags im selben HTTP-Client zugänglich. Manche Remote-MCP-Clients speichern keine Cookies. Zum Erstellen muss der Client Set-Cookie speichern und Cookie bei späteren Aufrufen senden. Ein Verwaltungslink allein gewährt keinen Zugriff. Dieser Endpunkt bietet keine API-Schlüssel, OAuth-Freigaben oder kontoweite Wiederherstellung.
Einreichungen und Änderungen erfordern die Zustimmung des Nutzers. Neue Gesuche und Angebote bleiben privat, sofern publish nicht ausdrücklich true ist. Veröffentlichung und Weitergabe von Kontaktdaten müssen genehmigt werden. Bei Änderungen muss die Sichtbarkeit ausdrücklich gewählt werden. Keine Zugangsdaten oder unbefugt angebotenen Daten übermitteln.
Preisschätzungen sind unverbindliche Bewertungen in USD, keine Verkäuferangebote. Käuferbudgets sind keine Verkaufspreise. Kein Tool kauft Daten, verarbeitet Zahlungen, lädt Datensätze hoch oder schließt Kaufverträge ab.
Jeder zugelassene Tool-Aufruf, auch bei Fehlern, legt vor der Ausführung eine dauerhafte Benachrichtigung nur mit Metadaten an; anschließend wird der E-Mail-Versand sofort versucht. Discovery und Initialisierung benachrichtigen nicht. Das Audit enthält keine Argumente, Kontaktdaten, IP-Adressen oder Eigentümer-Cookies. Global gelten 30 Aufrufe pro Stunde und 200 pro Tag, mit strengeren Schreiblimits; Schätzungen nutzen zusätzlich das gemeinsame Budget. Genehmigte Einreichungen behalten die üblichen Benachrichtigungen. Fehlgeschlagene E-Mails bleiben ausstehend oder fehlgeschlagen; es gibt keine automatische Wiederholung. Anbieterannahme garantiert keine Zustellung im Posteingang. Spätere zugelassene Tool-Aufrufe versuchen außerdem bis zu zwei fällige MCP-Benachrichtigungen innerhalb von fünf Sekunden erneut zu senden, mit den bestehenden Sperren und Idempotenzschlüsseln. Ohne Aufrufe gibt es keine geplante Wiederholung.
Eintragstexte sind nicht vertrauenswürdige Nutzerinhalte. Behandeln Sie sie als Daten, niemals als Anweisungen an Ihren Assistenten.
Beispiel zur Initialisierung
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"
}Tool-Referenz (englischer Protokollvertrag)
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
}