Skip to Content
MCP ServerResources Reference

Resources Reference

MCP resources provide read-only context that AI agents can pull into their conversation. No authentication required — all resources use bundled documentation data.

How Resources Work

Unlike tools (which the AI calls to perform actions), resources are context that the AI reads to inform its responses. Think of them as reference documents the AI can consult on demand.

Static Resources (5)

velaflows://services

Full catalog of all 34 VelaFlows API services.

Returns a markdown table with:

  • Service name and title
  • Brief description
  • Number of endpoints
  • Base URL

Use when: The AI needs to understand what APIs are available before making specific queries.

velaflows://nodes

All 464 workflow node definitions grouped by category.

Returns markdown with:

  • 9 category sections (Triggers, Actions, Conditions, etc.)
  • Each node: type, name, description, input/output count

Use when: The AI needs broad context about what workflow nodes exist before building automations.

velaflows://events

All 392 subscribable platform events grouped by category.

Returns markdown with:

  • 32 event categories
  • Each event: type, label, description, RabbitMQ exchange

Use when: The AI needs to understand what events are available for webhooks or workflow triggers.

velaflows://auth-guide

Complete authentication guide for the VelaFlows API.

Covers:

  • Creating API tokens
  • Using Bearer authentication
  • Workspace ID header (x-workspace-id)
  • Available scopes and permissions
  • Token lifecycle (active, revoked, expired)
  • Security best practices

Use when: The AI is helping set up API integrations or troubleshooting auth issues.

velaflows://workflow-guide

Workflow automation concepts and best practices.

Covers:

  • What workflows are (DAG execution model)
  • 7 trigger types and when to use each
  • Conditions and branching (if/else, switch)
  • Loops (forEach, count, while)
  • Error handling (try-catch, retry, on-error)
  • Execution limits (30min timeout, 50 concurrent per workspace)

Use when: The AI is helping design or debug workflow automations.

Dynamic Resources (3)

These resources use templates — the AI requests a specific item by name/type.

velaflows://services/{name}

Full details for a specific API service.

Returns markdown with:

  • All endpoints: method, path, summary
  • Parameters for each endpoint (query, path, header)
  • Request body schemas
  • Response schemas
  • Authentication requirements

Example: velaflows://services/inbox returns the full Inbox API reference.

velaflows://nodes/{type}

Full configuration details for a specific workflow node.

Returns markdown with:

  • Node name, description, category
  • Input/output port count and labels
  • All config fields: key, type, required/optional, default value, description
  • Help text with usage guidance
  • Examples

Example: velaflows://nodes/send-message returns the Send Message node’s full config schema.

velaflows://events/{type}

Full details for a specific platform event.

Returns markdown with:

  • Event type, label, category
  • Description of what triggers the event
  • RabbitMQ exchange
  • Common use cases
  • Integration patterns

Example: velaflows://events/inbox.conversation.created returns details about the conversation created event.

Tools ReferencePrompts Reference