MCP Resources

MCP resources provide read-only access to your lab's data. AI assistants can read these resources for context without making changes.

Resource URIs

Resources use the hubify:// URI scheme:

hubify://lab/status
hubify://experiments/exp_054
hubify://knowledge/kb_001

Available Resources

hubify://lab/status

Returns the current lab status overview, equivalent to what Captain View shows.

Returns:

{
  "lab": "bigbounce",
  "experiments": {
    "running": 2,
    "queued": 3,
    "completed_today": 5
  },
  "agents": {
    "total": 6,
    "active": 6,
    "idle": 1
  },
  "pods": {
    "active": 2,
    "gpu_utilization_avg": 0.87,
    "monthly_spend_usd": 312
  },
  "papers": [
    { "id": "paper-1", "readiness": 0.88 },
    { "id": "paper-2", "readiness": 0.45 }
  ]
}

hubify://experiments/{id}

Returns detailed information about a specific experiment.

Example: hubify://experiments/exp_054

Includes status, configuration, outputs, QC results, and cost.

hubify://experiments/recent

Returns the 10 most recent experiments with their status and key metrics.

hubify://knowledge/{id}

Returns the full content of a knowledge base entry.

Example: hubify://knowledge/kb_001

hubify://knowledge/search/{query}

Returns search results from the knowledge base.

Example: hubify://knowledge/search/f_NL%20non-gaussianity

hubify://papers/{id}

Returns paper metadata, readiness status, claims table, and review history.

Example: hubify://papers/paper-1

hubify://papers/{id}/draft

Returns the current LaTeX draft of a paper section.

Example: hubify://papers/paper-1/draft

hubify://tasks/queue

Returns the current priority task queue.

hubify://agents/{name}/activity

Returns recent activity for a specific agent.

Example: hubify://agents/Research%20Lead/activity

hubify://pods/metrics

Returns real-time metrics for all active pods.

Resource Templates

The MCP server also exposes resource templates that allow dynamic URI construction:

Template	Parameters	Description
hubify://experiments/{id}	id: Experiment ID	Experiment details
hubify://knowledge/{id}	id: Entry ID	Knowledge entry
hubify://knowledge/search/{query}	query: Search text	Knowledge search
hubify://papers/{id}	id: Paper ID	Paper status
hubify://agents/{name}/activity	name: Agent name	Agent activity

Usage in AI Assistants

When your AI assistant has the Hubify MCP server configured, it can read resources for context. For example, when writing a paper section, the assistant might read:

1. hubify://experiments/exp_054 to get the latest results
2. hubify://knowledge/search/bounce cosmology to find relevant background
3. hubify://papers/paper-1 to understand what sections are still needed

This gives the assistant rich, up-to-date context from your lab without manual copy-pasting.