feat(blocks): add external-service url to block metadata

- Add optional `url` field to BlockMeta for the integration's own homepage (e.g. exa.ai, salesforce.com), distinct from docsLink which points at Sim's docs - Populate `url` on all 209 integration blocks with verified homepages (protocol/internal blocks without a single vendor site are left without one) - Document the field in the add-block skill and command, with rule + checklist entries - Backfill missing docsLink on dspy and add a few accurate tag entries
simstudioai · waleedlatif1 · Jun 13, 2026 · Jun 13, 2026 · Jun 13, 2026 · Jun 13, 2026
commit b95d845cec7488aeb9fd0faec0219f9d3c8f787c
diff --git a/.agents/skills/add-block/SKILL.md b/.agents/skills/add-block/SKILL.md
@@ -640,6 +640,7 @@ import type { BlockConfig, BlockMeta } from '@/blocks/types'
 
 export const {Service}BlockMeta = {
   tags: ['messaging', 'automation'],   // Same tags as the block's tags field
+  url: 'https://{service}.com',         // Canonical homepage of the external service
   templates: [                          // Optional but strongly encouraged
     {
       icon: {Service}Icon,
@@ -666,6 +667,7 @@ export const {Service}BlockMeta = {
 
 - **Import `BlockMeta`** from `@/blocks/types` alongside `BlockConfig`
 - **`tags`** must match the `tags` array on the block config exactly
+- **`url`** is the canonical homepage of the external service the block integrates with (e.g. `'https://exa.ai'`, `'https://salesforce.com'`) — the catalog "link back to the tool". It is distinct from `BlockConfig.docsLink`, which points at Sim's own integration docs on `docs.sim.ai`. Use the service's real root domain over `https` (verify it actually resolves), no tracking params, no trailing slash. Omit `url` only for first-party/built-in blocks that have no external service (e.g. `agent`, `function`, `condition`, `api`, `response`)
 - **Templates are optional** but should be added for any integration that has a recognizable use case — aim for 2–4 templates per block
 - **Template `prompt`** should start with "Build a workflow that..." or "Create a workflow that..." and be concrete enough to generate a real workflow in Mothership
 - **Template `modules`** lists the Sim modules the template relies on: `'knowledge-base' | 'tables' | 'files' | 'workflows' | 'scheduled' | 'agent'`
@@ -906,6 +908,7 @@ All tool IDs referenced in `tools.access` and returned by `tools.config.tool` MU
 - [ ] Outputs match tool outputs
 - [ ] Block registered in `registry.ts` blocks object (alphabetically)
 - [ ] `{Service}BlockMeta` exported at bottom of block file with `tags` and `templates`
+- [ ] `url` set on `{Service}BlockMeta` to the external service's verified homepage (omit only for first-party blocks with no external service)
 - [ ] `skills` added to `{Service}BlockMeta`, each grounded in the block's `tools.access` and derived from a real online-sourced use case (not invented)
 - [ ] `BlockMeta` imported from `@/blocks/types` alongside `BlockConfig`
 - [ ] Block meta registered in `registry.ts` blocksMeta object (alphabetically)

diff --git a/.claude/commands/add-block.md b/.claude/commands/add-block.md
@@ -794,6 +794,7 @@ import type { BlockMeta } from '@/blocks/types'
 
 export const {Service}BlockMeta = {
   tags: ['tag1', 'tag2'],                  // IntegrationTag[]
+  url: 'https://{service}.com',            // external service homepage (verify it resolves) — NOT docs.sim.ai
   templates: [
     {
       icon: {Service}Icon,
@@ -845,6 +846,7 @@ Derive templates from the service's real use cases. Each prompt should name a co
 - [ ] Optional/rarely-used fields set to `mode: 'advanced'`
 - [ ] Timestamps and complex inputs have `wandConfig` enabled
 - [ ] Exported `{Service}BlockMeta` with at least 7 templates
+- [ ] `url` set on `{Service}BlockMeta` to the external service's verified homepage (omit only for first-party blocks with no external service)
 - [ ] `skills` added to `{Service}BlockMeta`, each grounded in `tools.access` and sourced from a real online use case (not invented)
 
 ## Final Validation (Required)

diff --git a/apps/sim/blocks/blocks/agentmail.ts b/apps/sim/blocks/blocks/agentmail.ts
@@ -623,6 +623,7 @@ export const AgentMailBlock: BlockConfig = {
 
 export const AgentMailBlockMeta = {
   tags: ['messaging', 'automation'],
+  url: 'https://agentmail.to',
   templates: [
     {
       icon: AgentMailIcon,

diff --git a/apps/sim/blocks/blocks/agentphone.ts b/apps/sim/blocks/blocks/agentphone.ts
@@ -752,6 +752,7 @@ export const AgentPhoneBlock: BlockConfig = {
 
 export const AgentPhoneBlockMeta = {
   tags: ['messaging', 'automation'],
+  url: 'https://agentphone.ai',
   templates: [
     {
       icon: AgentPhoneIcon,

diff --git a/apps/sim/blocks/blocks/agiloft.ts b/apps/sim/blocks/blocks/agiloft.ts
@@ -433,7 +433,8 @@ export const AgiloftBlock: BlockConfig = {
 }
 
 export const AgiloftBlockMeta = {
-  tags: ['automation'],
+  tags: ['automation', 'e-signatures'],
+  url: 'https://www.agiloft.com',
   templates: [
     {
       icon: AgiloftIcon,

diff --git a/apps/sim/blocks/blocks/ahrefs.ts b/apps/sim/blocks/blocks/ahrefs.ts
@@ -575,6 +575,7 @@ Return ONLY the date string in YYYY-MM-DD format - no explanations, no quotes, n
 
 export const AhrefsBlockMeta = {
   tags: ['seo', 'marketing', 'data-analytics'],
+  url: 'https://ahrefs.com',
   templates: [
     {
       icon: AhrefsIcon,

diff --git a/apps/sim/blocks/blocks/airtable.ts b/apps/sim/blocks/blocks/airtable.ts
@@ -348,6 +348,7 @@ Return ONLY the valid JSON object - no explanations, no markdown.`,
 
 export const AirtableBlockMeta = {
   tags: ['spreadsheet', 'automation'],
+  url: 'https://www.airtable.com',
   templates: [
     {
       icon: AirtableIcon,

diff --git a/apps/sim/blocks/blocks/airweave.ts b/apps/sim/blocks/blocks/airweave.ts
@@ -105,6 +105,7 @@ export const AirweaveBlock: BlockConfig<AirweaveSearchResponse> = {
 
 export const AirweaveBlockMeta = {
   tags: ['vector-search', 'knowledge-base'],
+  url: 'https://airweave.ai',
   templates: [
     {
       icon: AirweaveIcon,

diff --git a/apps/sim/blocks/blocks/algolia.ts b/apps/sim/blocks/blocks/algolia.ts
@@ -649,6 +649,7 @@ Return ONLY the JSON array.`,
 
 export const AlgoliaBlockMeta = {
   tags: ['vector-search', 'knowledge-base'],
+  url: 'https://www.algolia.com',
   templates: [
     {
       icon: AlgoliaIcon,

diff --git a/apps/sim/blocks/blocks/amplitude.ts b/apps/sim/blocks/blocks/amplitude.ts
@@ -748,6 +748,7 @@ export const AmplitudeBlock: BlockConfig = {
 
 export const AmplitudeBlockMeta = {
   tags: ['data-analytics', 'marketing'],
+  url: 'https://amplitude.com',
   templates: [
     {
       icon: AmplitudeIcon,

diff --git a/apps/sim/blocks/blocks/apify.ts b/apps/sim/blocks/blocks/apify.ts
@@ -240,6 +240,7 @@ Return ONLY the valid JSON object - no explanations, no markdown.`,
 
 export const ApifyBlockMeta = {
   tags: ['web-scraping', 'automation', 'data-analytics'],
+  url: 'https://apify.com',
   templates: [
     {
       icon: ApifyIcon,

diff --git a/apps/sim/blocks/blocks/apollo.ts b/apps/sim/blocks/blocks/apollo.ts
@@ -1375,6 +1375,7 @@ Return ONLY the timestamp string in ISO 8601 format - no explanations, no quotes
 
 export const ApolloBlockMeta = {
   tags: ['enrichment', 'sales-engagement'],
+  url: 'https://www.apollo.io',
   templates: [
     {
       icon: Users,

diff --git a/apps/sim/blocks/blocks/appconfig.ts b/apps/sim/blocks/blocks/appconfig.ts
@@ -588,6 +588,7 @@ export const AppConfigBlock: BlockConfig<
 
 export const AppConfigBlockMeta = {
   tags: ['cloud', 'feature-flags', 'automation'],
+  url: 'https://aws.amazon.com/systems-manager/features/appconfig',
   templates: [
     {
       icon: AppConfigIcon,

diff --git a/apps/sim/blocks/blocks/arxiv.ts b/apps/sim/blocks/blocks/arxiv.ts
@@ -156,6 +156,7 @@ export const ArxivBlock: BlockConfig<ArxivResponse> = {
 
 export const ArxivBlockMeta = {
   tags: ['document-processing', 'knowledge-base'],
+  url: 'https://arxiv.org',
   templates: [
     {
       icon: ArxivIcon,

diff --git a/apps/sim/blocks/blocks/asana.ts b/apps/sim/blocks/blocks/asana.ts
@@ -369,6 +369,7 @@ Return ONLY the date string in YYYY-MM-DD format - no explanations, no quotes, n
 
 export const AsanaBlockMeta = {
   tags: ['project-management', 'ticketing', 'automation'],
+  url: 'https://asana.com',
   templates: [
     {
       icon: AsanaIcon,

diff --git a/apps/sim/blocks/blocks/ashby.ts b/apps/sim/blocks/blocks/ashby.ts
@@ -970,6 +970,7 @@ Output only the ISO 8601 timestamp string, nothing else.`,
 
 export const AshbyBlockMeta = {
   tags: ['hiring'],
+  url: 'https://ashbyhq.com',
   templates: [
     {
       icon: AshbyIcon,

diff --git a/apps/sim/blocks/blocks/athena.ts b/apps/sim/blocks/blocks/athena.ts
@@ -470,6 +470,7 @@ Return ONLY the SQL query — no explanations, no markdown code blocks.`,
 
 export const AthenaBlockMeta = {
   tags: ['cloud', 'data-analytics'],
+  url: 'https://aws.amazon.com/athena',
   templates: [
     {
       icon: AthenaIcon,

diff --git a/apps/sim/blocks/blocks/attio.ts b/apps/sim/blocks/blocks/attio.ts
@@ -1327,6 +1327,7 @@ workspace-member.created
 
 export const AttioBlockMeta = {
   tags: ['sales-engagement', 'enrichment'],
+  url: 'https://attio.com',
   templates: [
     {
       icon: AttioIcon,

diff --git a/apps/sim/blocks/blocks/azure_devops.ts b/apps/sim/blocks/blocks/azure_devops.ts
@@ -627,6 +627,7 @@ export const AzureDevOpsBlock: BlockConfig<AzureDevOpsResponse> = {
 
 export const AzureDevOpsBlockMeta = {
   tags: ['version-control', 'ci-cd', 'project-management'],
+  url: 'https://azure.microsoft.com/products/devops',
   templates: [
     {
       icon: AzureIcon,

diff --git a/apps/sim/blocks/blocks/box.ts b/apps/sim/blocks/blocks/box.ts
@@ -601,6 +601,7 @@ export const BoxBlock: BlockConfig = {
 
 export const BoxBlockMeta = {
   tags: ['cloud', 'content-management', 'e-signatures'],
+  url: 'https://www.box.com',
   templates: [
     {
       icon: BoxCompanyIcon,

diff --git a/apps/sim/blocks/blocks/brandfetch.ts b/apps/sim/blocks/blocks/brandfetch.ts
@@ -100,6 +100,7 @@ export const BrandfetchBlock: BlockConfig<BrandfetchGetBrandResponse | Brandfetc
 
 export const BrandfetchBlockMeta = {
   tags: ['enrichment', 'marketing'],
+  url: 'https://brandfetch.com',
   templates: [
     {
       icon: BrandfetchIcon,

diff --git a/apps/sim/blocks/blocks/brex.ts b/apps/sim/blocks/blocks/brex.ts
@@ -572,6 +572,7 @@ export const BrexBlock: BlockConfig<BrexResponse> = {
 
 export const BrexBlockMeta = {
   tags: ['payments'],
+  url: 'https://www.brex.com',
   templates: [
     {
       icon: BrexIcon,

diff --git a/apps/sim/blocks/blocks/brightdata.ts b/apps/sim/blocks/blocks/brightdata.ts
@@ -346,6 +346,7 @@ export const BrightDataBlock: BlockConfig<BrightDataResponse> = {
 
 export const BrightDataBlockMeta = {
   tags: ['web-scraping', 'automation'],
+  url: 'https://brightdata.com',
   templates: [
     {
       icon: BrightDataIcon,

diff --git a/apps/sim/blocks/blocks/browser_use.ts b/apps/sim/blocks/blocks/browser_use.ts
@@ -214,6 +214,7 @@ export const BrowserUseBlock: BlockConfig<BrowserUseResponse> = {
 
 export const BrowserUseBlockMeta = {
   tags: ['web-scraping', 'automation', 'agentic'],
+  url: 'https://browser-use.com',
   templates: [
     {
       icon: BrowserUseIcon,

diff --git a/apps/sim/blocks/blocks/calcom.ts b/apps/sim/blocks/blocks/calcom.ts
@@ -920,6 +920,7 @@ Return ONLY valid JSON - no explanations.`,
 
 export const CalComBlockMeta = {
   tags: ['scheduling', 'calendar', 'meeting'],
+  url: 'https://cal.com',
   templates: [
     {
       icon: CalComIcon,

diff --git a/apps/sim/blocks/blocks/calendly.ts b/apps/sim/blocks/blocks/calendly.ts
@@ -330,6 +330,7 @@ Return ONLY the timestamp string in ISO 8601 format - no explanations, no quotes
 
 export const CalendlyBlockMeta = {
   tags: ['scheduling', 'calendar', 'meeting'],
+  url: 'https://calendly.com',
   templates: [
     {
       icon: CalendlyIcon,

diff --git a/apps/sim/blocks/blocks/circleback.ts b/apps/sim/blocks/blocks/circleback.ts
@@ -54,6 +54,7 @@ export const CirclebackBlock: BlockConfig = {
 
 export const CirclebackBlockMeta = {
   tags: ['meeting', 'note-taking'],
+  url: 'https://circleback.ai',
   templates: [
     {
       icon: CirclebackIcon,

diff --git a/apps/sim/blocks/blocks/clay.ts b/apps/sim/blocks/blocks/clay.ts
@@ -71,6 +71,7 @@ Plain Text: Best for populating a table in free-form style.
 
 export const ClayBlockMeta = {
   tags: ['enrichment', 'sales-engagement', 'data-analytics'],
+  url: 'https://www.clay.com',
   templates: [
     {
       icon: ClayIcon,

diff --git a/apps/sim/blocks/blocks/clerk.ts b/apps/sim/blocks/blocks/clerk.ts
@@ -412,6 +412,7 @@ export const ClerkBlock: BlockConfig<ClerkResponse> = {
 
 export const ClerkBlockMeta = {
   tags: ['identity', 'automation'],
+  url: 'https://clerk.com',
   templates: [
     {
       icon: ClerkIcon,

diff --git a/apps/sim/blocks/blocks/clickhouse.ts b/apps/sim/blocks/blocks/clickhouse.ts
@@ -467,6 +467,7 @@ export const ClickHouseBlock: BlockConfig<ClickHouseResponse> = {
 
 export const ClickHouseBlockMeta = {
   tags: ['data-warehouse', 'data-analytics'],
+  url: 'https://clickhouse.com',
   templates: [
     {
       icon: ClickHouseIcon,

diff --git a/apps/sim/blocks/blocks/cloudflare.ts b/apps/sim/blocks/blocks/cloudflare.ts
@@ -1100,6 +1100,7 @@ Return ONLY the comma-separated URLs - no explanations, no extra text.`,
 
 export const CloudflareBlockMeta = {
   tags: ['cloud', 'monitoring'],
+  url: 'https://www.cloudflare.com',
   templates: [
     {
       icon: CloudflareIcon,

diff --git a/apps/sim/blocks/blocks/cloudformation.ts b/apps/sim/blocks/blocks/cloudformation.ts
@@ -331,6 +331,7 @@ export const CloudFormationBlock: BlockConfig<
 
 export const CloudFormationBlockMeta = {
   tags: ['cloud'],
+  url: 'https://aws.amazon.com/cloudformation',
   templates: [
     {
       icon: CloudFormationIcon,

diff --git a/apps/sim/blocks/blocks/cloudwatch.ts b/apps/sim/blocks/blocks/cloudwatch.ts
@@ -879,6 +879,7 @@ Return ONLY the numeric timestamp - no explanations, no quotes, no extra text.`,
 
 export const CloudWatchBlockMeta = {
   tags: ['cloud', 'monitoring'],
+  url: 'https://aws.amazon.com/cloudwatch',
   templates: [
     {
       icon: CloudWatchIcon,

diff --git a/apps/sim/blocks/blocks/codepipeline.ts b/apps/sim/blocks/blocks/codepipeline.ts
@@ -504,6 +504,7 @@ export const CodePipelineBlock: BlockConfig<
 
 export const CodePipelineBlockMeta = {
   tags: ['cloud', 'ci-cd'],
+  url: 'https://aws.amazon.com/codepipeline',
   templates: [
     {
       icon: CodePipelineIcon,

diff --git a/apps/sim/blocks/blocks/confluence.ts b/apps/sim/blocks/blocks/confluence.ts
@@ -1604,6 +1604,7 @@ export const ConfluenceV2Block: BlockConfig<ConfluenceResponse> = {
 
 export const ConfluenceBlockMeta = {
   tags: ['knowledge-base', 'content-management', 'note-taking'],
+  url: 'https://www.atlassian.com/software/confluence',
   templates: [
     {
       icon: PagerDutyIcon,

diff --git a/apps/sim/blocks/blocks/convex.ts b/apps/sim/blocks/blocks/convex.ts
@@ -199,6 +199,7 @@ Return ONLY the JSON object - no explanations, no markdown, no extra text.`,
 
 export const ConvexBlockMeta = {
   tags: ['cloud'],
+  url: 'https://www.convex.dev',
   templates: [
     {
       icon: ConvexIcon,

diff --git a/apps/sim/blocks/blocks/crowdstrike.ts b/apps/sim/blocks/blocks/crowdstrike.ts
@@ -213,6 +213,7 @@ export const CrowdStrikeBlock: BlockConfig<CrowdStrikeResponse> = {
 
 export const CrowdStrikeBlockMeta = {
   tags: ['identity', 'monitoring'],
+  url: 'https://www.crowdstrike.com',
   templates: [
     {
       icon: CrowdStrikeIcon,

diff --git a/apps/sim/blocks/blocks/cursor.ts b/apps/sim/blocks/blocks/cursor.ts
@@ -280,6 +280,7 @@ export const CursorV2Block: BlockConfig<CursorResponse> = {
 
 export const CursorBlockMeta = {
   tags: ['agentic', 'automation'],
+  url: 'https://cursor.com',
   templates: [
     {
       icon: CursorIcon,

diff --git a/apps/sim/blocks/blocks/dagster.ts b/apps/sim/blocks/blocks/dagster.ts
@@ -671,6 +671,7 @@ Return ONLY the comma-separated asset keys - no explanations, no extra text.`,
 
 export const DagsterBlockMeta = {
   tags: ['data-analytics', 'automation'],
+  url: 'https://dagster.io',
   templates: [
     {
       icon: DagsterIcon,

diff --git a/apps/sim/blocks/blocks/databricks.ts b/apps/sim/blocks/blocks/databricks.ts
@@ -474,6 +474,7 @@ Return ONLY the numeric timestamp in milliseconds - no explanations, no extra te
 
 export const DatabricksBlockMeta = {
   tags: ['data-warehouse', 'data-analytics', 'cloud'],
+  url: 'https://www.databricks.com',
   templates: [
     {
       icon: DatabricksIcon,

diff --git a/apps/sim/blocks/blocks/datadog.ts b/apps/sim/blocks/blocks/datadog.ts
@@ -836,6 +836,7 @@ Return ONLY the numeric timestamp - no explanations, no quotes, no extra text.`,
 
 export const DatadogBlockMeta = {
   tags: ['monitoring', 'incident-management', 'error-tracking'],
+  url: 'https://www.datadoghq.com',
   templates: [
     {
       icon: DatadogIcon,

diff --git a/apps/sim/blocks/blocks/daytona.ts b/apps/sim/blocks/blocks/daytona.ts
@@ -565,6 +565,7 @@ export const DaytonaBlock: BlockConfig = {
 
 export const DaytonaBlockMeta = {
   tags: ['agentic', 'cloud', 'automation'],
+  url: 'https://www.daytona.io',
   templates: [
     {
       icon: DaytonaIcon,

diff --git a/apps/sim/blocks/blocks/devin.ts b/apps/sim/blocks/blocks/devin.ts
@@ -319,6 +319,7 @@ RULES:
 
 export const DevinBlockMeta = {
   tags: ['agentic', 'automation'],
+  url: 'https://devin.ai',
   templates: [
     {
       icon: DevinIcon,

diff --git a/apps/sim/blocks/blocks/discord.ts b/apps/sim/blocks/blocks/discord.ts
@@ -799,6 +799,7 @@ export const DiscordBlock: BlockConfig<DiscordResponse> = {
 
 export const DiscordBlockMeta = {
   tags: ['messaging', 'webhooks', 'automation'],
+  url: 'https://discord.com',
   templates: [
     {
       icon: DiscordIcon,

diff --git a/apps/sim/blocks/blocks/docusign.ts b/apps/sim/blocks/blocks/docusign.ts
@@ -375,6 +375,7 @@ export const DocuSignBlock: BlockConfig<DocuSignResponse> = {
 
 export const DocuSignBlockMeta = {
   tags: ['e-signatures', 'document-processing'],
+  url: 'https://www.docusign.com',
   templates: [
     {
       icon: DocuSignIcon,

diff --git a/apps/sim/blocks/blocks/dropbox.ts b/apps/sim/blocks/blocks/dropbox.ts
@@ -404,6 +404,7 @@ Return ONLY the timestamp string - no explanations, no quotes, no extra text.`,
 
 export const DropboxBlockMeta = {
   tags: ['cloud', 'document-processing'],
+  url: 'https://www.dropbox.com',
   templates: [
     {
       icon: DropboxIcon,