MCP Server

Spark - AI Assets Marketplace

io.github.entire-vc/spark
AI & Agents MCP & Agent Infrastructure Public & reachable MCP 2025-11-25

What this MCP does

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. Takes a slug, for example from a search result, a popular list or a link. Returns the full picture of the asset. It does not return the prompt/skill/agent text itself; get_asset_content returns that.
Read only Idempotent
Input schema
{'type': 'object', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'description': "Asset slug (e.g. 'vb-seo-expert', 'vb-python-expert')"}}, 'additionalProperties': False}
Output schema
{'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. Takes a slug. Unlike search_assets and get_asset, this counts as a download/acquisition event, and each call may return different content if the asset was updated. Paid assets require authentication: a Spark API key (X-API-Key header) or a Bearer token in the MCP client configuration. The response ends with an `application_id` line that identifies this fetch; report_outcome takes it as its `application_id` argument.
Input schema
{'type': 'object', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'description': 'Asset slug'}}, 'additionalProperties': False}
Output schema
{'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. Returns the domain slugs that search_assets accepts as its `domain` filter, and the AI tags, as a taxonomy of the catalog. Example: list_categories()
Read only Idempotent
Input schema
{'type': 'object', 'properties': {}, 'additionalProperties': False}
Output schema
{'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. Takes no search text; it returns the current top of the catalog by downloads.
Read only Idempotent
Input schema
{'type': 'object', 'properties': {'type': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Filter by asset type (agent, skill, prompt, prompt_chain, mcp_connector, bundle)'}, 'limit': {'type': 'integer', 'default': 10, 'description': 'Number of results (1-20, default 10)'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
report_outcome
Report outcome
Records the result of applying an asset that was fetched with get_asset_content: applied as is, applied with changes, broke, or not applicable. The report is tied to the application_id that get_asset_content returned; submitting the same application_id again updates the report. Reports made with an API key are counted; anonymous ones are stored as unverified. 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='<from get_asset_content>', result='applied_with_changes', task='add a rate limiter to the API', changed_what='swapped the fixed window for a token bucket').
Idempotent
Input schema
{'type': 'object', 'required': ['application_id', 'result', 'task'], 'properties': {'got': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'not_applicable: what it actually does (â\x89¤ 200).'}, 'note': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Anything else worth knowing (â\x89¤ 300).'}, 'task': {'type': 'string', 'description': 'What you were trying to do, one phrase (â\x89¤ 200).'}, 'model': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'The model you run on, if you know it. 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': 'not_applicable: what you were looking for (â\x89¤ 200).'}, 'failed_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'broke: the step, tool or command that failed, and the error class (â\x89¤ 200).'}, 'changed_what': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'applied_with_changes: what you changed (â\x89¤ 200).'}, 'application_id': {'type': 'string', 'description': 'The application_id at the end of the get_asset_content response.'}}, 'additionalProperties': False}
Output schema
{'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. Finds assets by text query, for when the slug is not known. Returns a numbered list of short summaries: title, type, downloads, outcome summary, price, tags and the asset's URL on spark.entire.vc.
Read only Idempotent
Input schema
{'type': 'object', 'required': ['query'], 'properties': {'job': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Job/task the agent is trying to accomplish. Enables job-based relevance ranking (e.g. 'review Python code', 'generate marketing copy', 'analyze data')."}, 'sort': {'type': 'string', 'default': 'combo', 'description': "Sort order: combo, popular, newest, rating. 'combo' = combined quality+ratings+agent outcomes score (default)."}, 'type': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Filter by asset type (agent, skill, prompt, prompt_chain, mcp_connector, bundle)'}, 'limit': {'type': 'integer', 'default': 10, 'description': 'Number of results (1-50, default 10)'}, 'query': {'type': 'string', 'description': 'Search text (matches title and description)'}, 'domain': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Filter by domain slug (e.g. 'development', 'marketing')"}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
Changed
list_categories
Sept. 27, 2026, 2:40 a.m.
Changed
list_popular
Sept. 27, 2026, 2:40 a.m.
Changed
report_outcome
Sept. 27, 2026, 2:40 a.m.
Changed
get_asset_content
Sept. 27, 2026, 2:40 a.m.
Changed
get_asset
Sept. 27, 2026, 2:40 a.m.
Changed
search_assets
Sept. 27, 2026, 2:40 a.m.
Added
list_categories
Sept. 25, 2026, 2:40 a.m.
Added
list_popular
Sept. 25, 2026, 2:40 a.m.
Added
report_outcome
Sept. 25, 2026, 2:40 a.m.
Added
get_asset_content
Sept. 25, 2026, 2:40 a.m.
Added
get_asset
Sept. 25, 2026, 2:40 a.m.
Added
search_assets
Sept. 25, 2026, 2:40 a.m.