Serveur MCP

Spark - AI Assets Marketplace

io.github.entire-vc/spark
IA et agents Infrastructure MCP et agents Public et accessible MCP 2025-11-25

Ce que fait ce MCP

Searches an AI asset marketplace and retrieves details or content for agents, skills, prompts, MCP connectors, and related bundles.

get_asset
Get asset details
Get full details of a Spark asset by its slug — description, metadata, outcome reports, bundled files and the URL on spark.entire.vc. For when a known slug needs inspection before acquisition. Returns Markdown details, which may include embedded content; get_asset_content obtains the raw content and a receipt. Public catalog lookup, no login or download recorded. Missing or unavailable slugs return a not-found message. For example, get_asset(slug='vb-seo-expert').
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'description': "Exact asset slug from a search result or Spark URL, e.g. 'vb-seo-expert'; not a URL or asset ID."}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
get_asset_content
Get asset content
Get the raw content of a Spark asset (prompt text, skill instructions, agent config) — the actual text to apply, not just a description of it. For when a known asset's content is needed for application; get_asset provides details without acquisition. Each successful fetch records a download/acquisition; repeated calls create new receipts and content may change after updates. Free content needs no login. Paid content requires a Spark API key (X-API-Key) or Bearer token and prior purchase or ownership; this tool makes no purchase. Returns content and an application_id for report_outcome, or a not-found/access message. Content may be a source link rather than embedded text. For example, get_asset_content(slug='vb-seo-expert').
Schéma d’entrée
{'type': 'object', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'description': "Exact asset slug from a search result or Spark URL, e.g. 'vb-seo-expert'; not a URL or asset ID."}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
list_categories
List categories
List available categories (domains and AI tags) in the Spark marketplace. For when domain filter values or taxonomy are needed; search_assets returns assets rather than categories. Takes no parameters. Returns Markdown lists of AI tag names/slugs and domain names/slugs grouped by parent category; domain slugs are accepted by search_assets' domain filter. AI tags are not a search_assets filter. Public catalog lookup, no login or download recorded. For example, list_categories().
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'properties': {}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
list_popular
List popular assets
List the most popular Spark assets by download count, optionally filtered by type. For when browsing without a text query; search_assets finds text matches. Returns numbered summaries with outcomes, price, tags and URLs, or 'No assets found.' Downloads measure acquisitions, not successful applications or ratings. Public catalog lookup, no login or download recorded. For example, list_popular(type='skill', limit=5).
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'properties': {'type': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Optional asset type: agent, skill, prompt, prompt_chain, mcp_connector or bundle; omitted means all types.'}, 'limit': {'type': 'integer', 'default': 10, 'description': 'Maximum results; clamped to 1-20, default 10.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
report_outcome
Report outcome
Records the result of applying a fetched Spark asset: applied as is, changed, broke, or not applicable. For when the outcome is known and an application_id from get_asset_content is available, rather than a star rating. Mismatched user/session receipts are rejected; asset owners cannot report on their own assets. Submitting the same application_id updates the report. Authenticated reports count, but team reports do not affect rankings; anonymous reports are unverified. Returns a saved/updated confirmation, or a validation/receipt error. Fields `task`, `note`, `changed_what`, `failed_at`, `expected`, `got` are published on the asset's public page on spark.entire.vc, visible to any visitor. Do not include client data, private paths, keys, emails or URLs with tokens. Your identity is never shown on that page. Example: report_outcome(application_id='<receipt>', result='applied_as_is', task='add a rate limiter').
Idempotent
Schéma d’entrée
{'type': 'object', 'required': ['application_id', 'result', 'task'], 'properties': {'got': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Required for not_applicable: what the asset actually does (â\x89¤ 200 characters); ignored for other results.'}, 'note': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Optional extra context (â\x89¤ 300 characters); published on the asset page.'}, 'task': {'type': 'string', 'description': 'Required nonempty task attempted, one phrase (â\x89¤ 200 characters); published on the asset page.'}, 'model': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Optional model name; trimmed to 100 characters. Shown, never ranked.'}, 'result': {'enum': ['applied_as_is', 'applied_with_changes', 'broke', 'not_applicable'], 'type': 'string', 'description': 'applied_as_is: applied without edits, task solved. applied_with_changes: had to edit it, then solved (requires changed_what). broke: tried to apply and it failed (requires failed_at). not_applicable: read it and did not apply, it does something else (requires expected and got).'}, 'expected': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Required for not_applicable: what was sought (â\x89¤ 200 characters); ignored for other results.'}, 'failed_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Required for broke: failed step, tool or command and error class (â\x89¤ 200 characters); ignored for other results.'}, 'changed_what': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Required for applied_with_changes: what changed (â\x89¤ 200 characters); ignored for other results.'}, 'application_id': {'type': 'string', 'description': 'The application_id at the end of the get_asset_content response.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
search_assets
Search assets
Search the Spark AI assets marketplace for agents, skills, prompts, prompt chains, MCP connectors and bundles. For when a text query is available but the slug is not known; get_asset describes a known slug. Returns numbered summaries with type, downloads, outcomes, price, tags and URL, or a no-results message. No login required; no acquisition is made. Unmatched nonempty queries may be recorded as unmet catalog needs. A nonempty job ranks text matches by task fit, even with a non-combo sort. For example, search_assets(query='rate limiting', job='add a rate limiter', limit=5).
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'required': ['query'], 'properties': {'job': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Optional task, e.g. 'review Python code'; a nonempty value enables job-based ranking regardless of sort."}, 'sort': {'type': 'string', 'default': 'combo', 'description': 'combo (default): quality, ratings and outcomes; popular: downloads; newest: creation date; rating: average rating. Invalid values fall back to combo; job enables ranking for any sort.'}, 'type': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Optional asset type: agent, skill, prompt, prompt_chain, mcp_connector or bundle; omitted means all types.'}, 'limit': {'type': 'integer', 'default': 10, 'description': 'Maximum results; clamped to 1-50, default 10.'}, 'query': {'type': 'string', 'description': "Text matched against titles and descriptions, e.g. 'rate limiting'; empty text browses the catalog."}, 'domain': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Optional domain slug from list_categories, e.g. 'development'; omitted means all domains."}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
Modifié
list_categories
3 October 2026 02:50
Modifié
list_popular
3 October 2026 02:50
Modifié
report_outcome
3 October 2026 02:50
Modifié
get_asset_content
3 October 2026 02:50
Modifié
get_asset
3 October 2026 02:50
Modifié
search_assets
3 October 2026 02:50
Modifié
list_categories
27 September 2026 02:40
Modifié
list_popular
27 September 2026 02:40
Modifié
report_outcome
27 September 2026 02:40
Modifié
get_asset_content
27 September 2026 02:40
Modifié
get_asset
27 September 2026 02:40
Modifié
search_assets
27 September 2026 02:40
Ajouté
list_categories
25 September 2026 02:40
Ajouté
list_popular
25 September 2026 02:40
Ajouté
report_outcome
25 September 2026 02:40
Ajouté
get_asset_content
25 September 2026 02:40
Ajouté
get_asset
25 September 2026 02:40
Ajouté
search_assets
25 September 2026 02:40