Skip to main content

Resources Reference

Browse platform data via lovelace:// URIs

MCP resources provide read-only access to platform data. Clients can list available resources and read their contents using the standard MCP resource protocol.

URI Scheme

All Lovelace resources use the lovelace:// URI scheme:

lovelace://{resource-type}/{identifier}

Workspace Resources

List Workspaces

URI: lovelace://workspaces

Returns a list of all workspaces accessible to the authenticated user.

json
{
  "uri": "lovelace://workspaces",
  "name": "Lovelace Workspaces",
  "mimeType": "application/json"
}

Content:

json
{
  "workspaces": [
    {
      "id": "ws_abc123",
      "name": "My Project",
      "description": "Main development workspace"
    }
  ]
}

Workspace Details

URI: lovelace://workspaces/{workspaceId}

Returns detailed information about a specific workspace.

Example: lovelace://workspaces/ws_abc123

Content:

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

Agent Resources

Agent Status

URI: lovelace://agents/{executionId}/status

Returns the current execution status of an agent.

Example: lovelace://agents/exec_def456/status

Content:

json
{
  "executionId": "exec_def456",
  "agentId": "code-reviewer",
  "status": "running",
  "progress": 65,
  "startedAt": "2025-02-17T12:00:00Z"
}

Agent Output

URI: lovelace://agents/{executionId}/output

Returns the output from a completed agent execution.

Example: lovelace://agents/exec_def456/output

Content:

json
{
  "executionId": "exec_def456",
  "output": "Found 3 potential security issues...",
  "artifacts": [
    {
      "name": "security-report.md",
      "type": "text/markdown"
    }
  ]
}

Knowledge Resources

Knowledge Document

URI: lovelace://knowledge/{documentId}

Returns the content of a specific knowledge document.

Example: lovelace://knowledge/doc_ghi789

Content:

json
{
  "id": "doc_ghi789",
  "title": "Authentication Architecture",
  "content": "# Authentication Architecture\n\nOur authentication system...",
  "tags": ["architecture", "auth"],
  "createdAt": "2025-01-20T09:00:00Z",
  "updatedAt": "2025-01-25T15:00:00Z"
}

Resource Subscriptions

Clients that support MCP resource subscriptions can receive real-time notifications when resources change. The Lovelace MCP server emits resources/updated notifications for:

  • Agent status changes — When an agent transitions between states (queued, running, completed, failed)
  • Workspace updates — When workspace metadata or membership changes
  • Knowledge updates — When documents are created, updated, or deleted

To subscribe, use the standard MCP resources/subscribe method:

json
{
  "method": "resources/subscribe",
  "params": {
    "uri": "lovelace://agents/exec_def456/status"
  }
}

Using Resources in Clients

Most MCP clients handle resources automatically. When connected to the Lovelace server, you can ask your AI assistant to read resources directly:

Show me the details of my workspace ws_abc123

The client will read lovelace://workspaces/ws_abc123 and display the result.