The Open Framework for Building Agents
feat: add DataForSEO as an official MCP connection (#4397)
Colton Padden5139768f805c
diff --git a/apps/docs/registry.json b/apps/docs/registry.jsonindex 04b63d808..cbda3743b 100644--- a/apps/docs/registry.json+++ b/apps/docs/registry.json@@ -492,6 +492,23 @@}]},+ {+ "name": "connection/dataforseo",+ "type": "registry:item",+ "title": "DataForSEO",+ "description": "Run SEO, keyword, and SERP data lookups through DataForSEO's MCP server.",+ "envVars": {+ "DATAFORSEO_USERNAME": "",+ "DATAFORSEO_PASSWORD": ""+ },+ "files": [+ {+ "path": "registry/connections/dataforseo.ts",+ "type": "registry:file",+ "target": "agent/connections/dataforseo.ts"+ }+ ]+ },{"name": "connection/vercel","type": "registry:item",diff --git a/apps/docs/registry/connections/dataforseo.ts b/apps/docs/registry/connections/dataforseo.tsnew file mode 100644index 000000000..56be1e930--- /dev/null+++ b/apps/docs/registry/connections/dataforseo.ts@@ -0,0 +1,15 @@+import { defineMcpClientConnection } from "eve/connections";++export default defineMcpClientConnection({+ url: "https://mcp.dataforseo.com/v3/mcp",+ description:+ "DataForSEO: run SEO, keyword, and SERP data lookups through DataForSEO's MCP server.",+ headers: () => {+ const login = process.env.DATAFORSEO_USERNAME!;+ const password = process.env.DATAFORSEO_PASSWORD!;+ const token = Buffer.from(`${login}:${password}`).toString("base64");+ return {+ Authorization: `Basic ${token}`,+ };+ },+});diff --git a/apps/docs/scripts/validate-connection-registry.ts b/apps/docs/scripts/validate-connection-registry.tsindex a3ed38c82..3663f1e67 100644--- a/apps/docs/scripts/validate-connection-registry.ts+++ b/apps/docs/scripts/validate-connection-registry.ts@@ -43,6 +43,7 @@ const expectedSlugs = connectionEntries().filter((entry) => entry.surfaces.registry).map((entry) => entry.slug);const actualSlugs = items.map((item) => item.name.slice("connection/".length));+const NON_CONNECT_SLUGS = new Set(["browser-use", "dataforseo"]);const CONNECT_SERVICES: Readonly<Record<string, string>> = {agentcard: "mcp.agentcard.sh/mcp",vercel: "vercel",@@ -72,6 +73,9 @@ if (JSON.stringify(actualSlugs) !== JSON.stringify(expectedSlugs)) {}for (const item of items) {+ const slug = item.name.slice("connection/".length);+ if (NON_CONNECT_SLUGS.has(slug)) continue;+const declaredSetup = item.meta?.eve?.setup;const setups =declaredSetup === undefined@@ -93,41 +97,38 @@ for (const item of items) {);}- const slug = item.name.slice("connection/".length);- if (slug !== "browser-use") {- const creationType = CONNECT_CREATION_TYPES[slug];- const connectionMethod = CONNECT_METHODS[slug];- const principalType = CONNECT_PRINCIPAL_TYPES[slug];- const expectedSetup =+ const creationType = CONNECT_CREATION_TYPES[slug];+ const connectionMethod = CONNECT_METHODS[slug];+ const principalType = CONNECT_PRINCIPAL_TYPES[slug];+ const expectedSetup =+ slug === "shopify"+ ? {+ command: "eve",+ package: "eve",+ bin: "eve",+ args: ["integration", "setup", "shopify"],+ }+ : {+ command: "eve",+ package: "eve",+ bin: "eve",+ args: [+ "integration",+ "connect",+ slug,+ CONNECT_SERVICES[slug] ?? slug,+ slug,+ ...(creationType === undefined ? [] : ["--creation-type", creationType]),+ ...(connectionMethod === undefined ? [] : ["--connection-method", connectionMethod]),+ ...(principalType === undefined ? [] : ["--principal-type", principalType]),+ ],+ };+ if (JSON.stringify(setups) !== JSON.stringify([expectedSetup])) {+ throw new Error(slug === "shopify"- ? {- command: "eve",- package: "eve",- bin: "eve",- args: ["integration", "setup", "shopify"],- }- : {- command: "eve",- package: "eve",- bin: "eve",- args: [- "integration",- "connect",- slug,- CONNECT_SERVICES[slug] ?? slug,- slug,- ...(creationType === undefined ? [] : ["--creation-type", creationType]),- ...(connectionMethod === undefined ? [] : ["--connection-method", connectionMethod]),- ...(principalType === undefined ? [] : ["--principal-type", principalType]),- ],- };- if (JSON.stringify(setups) !== JSON.stringify([expectedSetup])) {- throw new Error(- slug === "shopify"- ? 'Registry item "connection/shopify" must run eve integration setup shopify.'- : `Registry item "${item.name}" must configure its Vercel Connect connector through eve.`,- );- }+ ? 'Registry item "connection/shopify" must run eve integration setup shopify.'+ : `Registry item "${item.name}" must configure its Vercel Connect connector through eve.`,+ );}const expectedPath = `registry/connections/${slug}.ts`;@@ -141,14 +142,6 @@ for (const item of items) {await access(join(docsRoot, expectedPath));switch (slug) {- case "browser-use": {- if (item.dependencies !== undefined || !("BROWSER_USE_API_KEY" in (item.envVars ?? {}))) {- throw new Error(- 'Registry item "connection/browser-use" must declare its API key without Vercel Connect.',- );- }- break;- }case "shopify": {if (item.dependencies !== undefined) {throw new Error('Registry item "connection/shopify" must not declare dependencies.');diff --git a/packages/eve-catalog/src/index.ts b/packages/eve-catalog/src/index.tsindex f0c485ce6..7e624003f 100644--- a/packages/eve-catalog/src/index.ts+++ b/packages/eve-catalog/src/index.ts@@ -391,6 +391,18 @@ export const INTEGRATIONS: readonly IntegrationEntry[] = [mcp: { url: "https://api.browser-use.com/v3/mcp" },},},+ {+ slug: "dataforseo",+ name: "DataForSEO",+ kind: "connection",+ tagline: "Run SEO, keyword, and SERP data lookups through DataForSEO's MCP server.",+ surfaces: { scaffoldable: false, registry: true, gallery: false },+ connection: {+ description:+ "DataForSEO: run SEO, keyword, and SERP data lookups through DataForSEO's MCP server.",+ mcp: { url: "https://mcp.dataforseo.com/v3/mcp" },+ },+ },{slug: "vercel",name: "Vercel",