Skip to main content

Resources Reference

Read Lovelace platform data through lovelace:// URIs

The public MCP gateway exposes read-only MCP resources alongside its tools.

Workspace Resources

lovelace://workspaces

Returns the list of workspaces accessible to the authenticated user.

json
{
  "workspaces": [
    {
      "id": "ws_abc123",
      "name": "My Project",
      "description": "Main development workspace",
      "memberCount": 3,
      "createdAt": "2025-01-15T10:00:00.000Z",
      "updatedAt": "2025-02-01T14:30:00.000Z"
    }
  ],
  "total": 1
}

lovelace://workspaces/{workspaceId}

Returns a specific workspace.

Example: lovelace://workspaces/ws_abc123

json
{
  "id": "ws_abc123",
  "name": "My Project",
  "description": "Main development workspace",
  "ownerId": "user_123",
  "memberCount": 3,
  "createdAt": "2025-01-15T10:00:00.000Z",
  "updatedAt": "2025-02-01T14:30:00.000Z"
}

Agent Resources

lovelace://agents

This is a discovery placeholder resource. Use lovelace_list_agents to discover agent IDs, then read the concrete status/output URIs below.

lovelace://agents/{agentId}/status

Returns the current status for an agent.

Example: lovelace://agents/agent_123/status

json
{
  "id": "agent_123",
  "name": "API Review Agent",
  "description": "Performance review run",
  "type": "general",
  "task": "Review API bottlenecks",
  "status": "completed",
  "statusMessage": "Finished successfully",
  "workspaceId": "ws_abc123",
  "createdAt": "2025-02-17T12:00:00.000Z",
  "updatedAt": "2025-02-17T12:05:30.000Z",
  "completedAt": "2025-02-17T12:05:30.000Z"
}

lovelace://agents/{agentId}/output

Returns the result payload for an agent.

Example: lovelace://agents/agent_123/output

json
{
  "agentId": "agent_123",
  "status": "completed",
  "result": {
    "summary": "Found 3 bottlenecks in the authentication flow"
  },
  "artifacts": [
    {
      "id": "artifact_1",
      "name": "report.md",
      "mimeType": "text/markdown",
      "uri": "https://example.com/report.md"
    }
  ],
  "error": null
}

Knowledge Resources

lovelace://knowledge

This is a discovery placeholder resource. Use lovelace_search_knowledge to find relevant documents, then read a specific document URI.

lovelace://knowledge/{documentId}

Returns a stored knowledge document.

Example: lovelace://knowledge/doc_456

json
{
  "id": "doc_456",
  "title": "Authentication Architecture",
  "content": "# Authentication Architecture\n\nOur authentication system...",
  "mimeType": "text/markdown",
  "workspaceId": "ws_abc123",
  "metadata": {
    "source": "engineering-handbook"
  },
  "createdAt": "2025-01-20T09:00:00.000Z",
  "updatedAt": "2025-01-25T15:00:00.000Z"
}

Usage Notes

  • Workspace resources are listed directly by the gateway
  • Agent and knowledge resources are discovered dynamically through tools
  • The public launch docs do not promise resource subscription behavior for the public gateway