Overview
subscribe_to_model creates an active subscription for the authenticated user to a given model. Without a valid subscription, calls to run_signal for that model will be rejected.
Auth required — include your QuantSpace Bearer token in the MCP client configuration.
Authentication
Add the token to your MCP client config:
{
"mcpServers": {
"quantx-marketplace": {
"url": "https://quantx-marketplace.quantspace.io/mcp",
"headers": {
"Authorization": "Bearer <your_quantspace_token>"
}
}
}
}
Parameters
Unique model identifier. Obtained from search_marketplace or get_model.Example: "qx-mom-us-001"
Subscription plan. Accepted values:| Value | Description |
|---|
"trial" | Free trial (duration varies by model, typically 14 days) |
"monthly" | Monthly recurring subscription |
"annual" | Annual subscription (typically 20% discount) |
"trial" if eligible, otherwise "monthly".
Returns
{
"subscription_id": "sub_8f2a1c9d",
"model_id": "qx-mom-us-001",
"model_name": "US Large-Cap Momentum",
"plan": "trial",
"status": "active",
"started_at": "2026-04-06T09:15:00Z",
"expires_at": "2026-04-20T09:15:00Z",
"trial": true,
"message": "14-day free trial started. You can now run signals for this model."
}
| Field | Description |
|---|
subscription_id | Unique subscription ID — useful for billing/audit |
status | "active", "pending", "expired" |
expires_at | Subscription expiry timestamp (ISO 8601) |
trial | true if on free trial |
Error Codes
| Code | Meaning |
|---|
ALREADY_SUBSCRIBED | An active subscription already exists for this model |
TRIAL_USED | Free trial was already consumed for this model |
AUTH_REQUIRED | Bearer token missing or invalid |
MODEL_NOT_FOUND | The specified model_id does not exist |
Example
{
"model_id": "qx-mom-us-001",
"plan": "trial"
}
Next Step
With an active subscription, pass model_id to run_signal on the Signals Server.
