Skip to content

armgit / eve

Public Imported from GitHub
0

The Open Framework for Building Agents

Add Firecrawl MCP connection to the registry (#5248)

Colton Paddenc49ddb97f499
diff --git a/apps/docs/lib/integrations/connection-setup.test.ts b/apps/docs/lib/integrations/connection-setup.test.ts
index 9366ad2a1..1d61f96e0 100644
--- a/apps/docs/lib/integrations/connection-setup.test.ts
+++ b/apps/docs/lib/integrations/connection-setup.test.ts
@@ -33,6 +33,26 @@ describe("Browser Use connection setup", () => {
});
});
+describe("Firecrawl connection setup", () => {
+ it("renders bearer authentication for cost-sensitive tools", () => {
+ const integration = getIntegration("firecrawl")!;
+
+ expect(integration.quickStart).toContain(
+ "Authorization: `Bearer ${process.env.FIRECRAWL_API_KEY!}`",
+ );
+ expect(buildConnectionInstall(integration)).toContain("eve add connection/firecrawl");
+ });
+
+ it("shows the installed connection file in the gallery", () => {
+ const source = readFileSync(
+ new URL("../../registry/connections/firecrawl.ts", import.meta.url),
+ "utf8",
+ );
+
+ expect(getIntegration("firecrawl")!.quickStart).toContain(source.trim());
+ });
+});
+
describe("Agentcard connection setup", () => {
it("uses the standard connector name for the native Vercel Connect service", () => {
const integration = getIntegration("agentcard")!;
diff --git a/apps/docs/lib/integrations/data.ts b/apps/docs/lib/integrations/data.ts
index 45a8c07b0..9e672f476 100644
--- a/apps/docs/lib/integrations/data.ts
+++ b/apps/docs/lib/integrations/data.ts
@@ -2154,6 +2154,35 @@ Connect owns the OAuth flow, and each end-user authorizes in their own browser b
keywords: ["mcp", "treasury", "cash", "payments", "accounting", "oauth", "connect"],
authModes: ["user"],
},
+ firecrawl: {
+ logo: "firecrawl",
+ docsHref: "https://docs.firecrawl.dev/mcp-server",
+ keywords: ["mcp", "web search", "web scraping", "crawl", "parse", "monitoring"],
+ authModes: ["apiKey"],
+ apiKey: {
+ env: "FIRECRAWL_API_KEY",
+ header: "Authorization",
+ },
+ quickStart: `Create \`agent/connections/firecrawl.ts\`. The filename creates the \`firecrawl\` connection. Firecrawl calls can consume usage or create persistent work, so this connection requires approval for every call:
+
+\`\`\`ts
+import { always } from "eve/tools/approval";
+import { defineMcpClientConnection } from "eve/connections";
+
+export default defineMcpClientConnection({
+ url: "https://mcp.firecrawl.dev/v2/mcp",
+ description: "Firecrawl: search, scrape, map, crawl, parse, and monitor web content.",
+ headers: () => ({
+ Authorization: \`Bearer \${process.env.FIRECRAWL_API_KEY!}\`,
+ }),
+ approval: always(),
+});
+\`\`\`
+
+Keep the API key in a server-side environment variable. eve sends it directly to Firecrawl and does not expose it to the model.`,
+ configureNote:
+ "An API key enables Firecrawl's full tool surface, subject to the plan and team policy. Keep approval enabled, or use tool filters and approval rules that prevent unattended cost-sensitive or persistent actions.",
+ },
"hugging-face": {
logo: "hugging-face",
docsHref: "/docs/connections/mcp",
diff --git a/apps/docs/lib/integrations/logos.tsx b/apps/docs/lib/integrations/logos.tsx
index f5a02c204..f6b821df8 100644
--- a/apps/docs/lib/integrations/logos.tsx
+++ b/apps/docs/lib/integrations/logos.tsx
@@ -399,6 +399,15 @@ const embatLogo = (props: LogoProps) => (
</svg>
);
+const firecrawlLogo = (props: LogoProps) => (
+ <svg fill="none" viewBox="0 0 200 284" xmlns="http://www.w3.org/2000/svg" {...props}>
+ <path
+ d="M166.862 90.7716C155.812 94.0514 147.483 101.471 141.383 109.53C140.073 111.26 137.343 109.96 137.863 107.841C149.543 59.8136 134.113 19.896 86.0157 0.247269C83.5758 -0.752669 81.0359 1.43719 81.6759 3.99704C103.555 91.8416 11.5294 84.432 23.1588 184.016C23.3588 185.726 21.4389 186.896 20.039 185.896C15.6792 182.766 10.8095 176.236 7.46963 171.647C6.48968 170.297 4.36978 170.677 3.9198 172.287C1.25994 181.906 0 190.965 0 199.965C0 234.963 17.9891 265.771 45.2177 283.63C46.7777 284.65 48.7776 283.19 48.2476 281.4C46.8477 276.7 46.0577 271.74 45.9977 266.611C45.9977 263.461 46.1977 260.241 46.6877 257.241C47.8276 249.702 50.4475 242.522 54.8473 235.983C69.9365 213.334 100.185 191.455 95.3552 161.747C95.0453 159.867 97.2651 158.627 98.6651 159.917C119.974 179.386 124.194 205.575 120.694 229.063C120.394 231.103 122.954 232.193 124.244 230.593C127.504 226.513 131.483 222.933 135.813 220.244C136.893 219.574 138.333 220.084 138.743 221.284C141.153 228.293 144.733 234.873 148.113 241.452C152.152 249.362 154.302 258.391 153.962 267.951C153.792 272.6 153.022 277.1 151.732 281.38C151.182 283.19 153.162 284.7 154.752 283.66C182.001 265.801 200 234.993 200 199.975C200 187.806 197.87 175.876 193.84 164.697C185.391 141.248 163.952 123.64 169.372 93.0815C169.632 91.6216 168.282 90.3517 166.862 90.7716Z"
+ fill="currentColor"
+ />
+ </svg>
+);
+
const localFalconLogo = (props: LogoProps) => (
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1000 1000" {...props}>
<g transform="translate(196.49, 75) scale(0.85)">
@@ -876,6 +885,7 @@ export const logos = {
coda: codaLogo,
egnyte: egnyteLogo,
embat: embatLogo,
+ firecrawl: firecrawlLogo,
"hugging-face": huggingFaceLogo,
"local-falcon": localFalconLogo,
make: makeLogo,
diff --git a/apps/docs/registry.json b/apps/docs/registry.json
index f3254e7ac..d9dc32ca3 100644
--- a/apps/docs/registry.json
+++ b/apps/docs/registry.json
@@ -1109,6 +1109,22 @@
}
]
},
+ {
+ "name": "connection/firecrawl",
+ "type": "registry:item",
+ "title": "Firecrawl",
+ "description": "Search, scrape, map, crawl, parse, and monitor web content.",
+ "envVars": {
+ "FIRECRAWL_API_KEY": ""
+ },
+ "files": [
+ {
+ "path": "registry/connections/firecrawl.ts",
+ "type": "registry:file",
+ "target": "agent/connections/firecrawl.ts"
+ }
+ ]
+ },
{
"name": "connection/hugging-face",
"type": "registry:item",
diff --git a/apps/docs/registry/connections/firecrawl.ts b/apps/docs/registry/connections/firecrawl.ts
new file mode 100644
index 000000000..1346d6033
--- /dev/null
+++ b/apps/docs/registry/connections/firecrawl.ts
@@ -0,0 +1,11 @@
+import { always } from "eve/tools/approval";
+import { defineMcpClientConnection } from "eve/connections";
+
+export default defineMcpClientConnection({
+ url: "https://mcp.firecrawl.dev/v2/mcp",
+ description: "Firecrawl: search, scrape, map, crawl, parse, and monitor web content.",
+ headers: () => ({
+ Authorization: `Bearer ${process.env.FIRECRAWL_API_KEY!}`,
+ }),
+ approval: always(),
+});
diff --git a/apps/docs/scripts/validate-connection-registry.ts b/apps/docs/scripts/validate-connection-registry.ts
index 8c51976c3..4b2db71af 100644
--- a/apps/docs/scripts/validate-connection-registry.ts
+++ b/apps/docs/scripts/validate-connection-registry.ts
@@ -43,7 +43,11 @@ 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 API_KEY_CONNECTIONS: Readonly<Record<string, readonly string[]>> = {
+ "browser-use": ["BROWSER_USE_API_KEY"],
+ dataforseo: ["DATAFORSEO_USERNAME", "DATAFORSEO_PASSWORD"],
+ firecrawl: ["FIRECRAWL_API_KEY"],
+};
const CONNECT_SERVICES: Readonly<Record<string, string>> = {
agentcard: "mcp.agentcard.sh/mcp",
vercel: "vercel",
@@ -76,8 +80,6 @@ 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
@@ -125,11 +127,14 @@ for (const item of items) {
...(principalType === undefined ? [] : ["--principal-type", principalType]),
],
};
- if (JSON.stringify(setups) !== JSON.stringify([expectedSetup])) {
+ const expectedSetups = slug in API_KEY_CONNECTIONS ? undefined : [expectedSetup];
+ if (JSON.stringify(setups) !== JSON.stringify(expectedSetups)) {
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.`,
+ slug in API_KEY_CONNECTIONS
+ ? `Registry item "${item.name}" must not configure Vercel Connect for API-key authentication.`
+ : slug === "shopify"
+ ? 'Registry item "connection/shopify" must run eve integration setup shopify.'
+ : `Registry item "${item.name}" must configure its Vercel Connect connector through eve.`,
);
}
@@ -156,6 +161,18 @@ for (const item of items) {
break;
}
default: {
+ const requiredEnvVars = API_KEY_CONNECTIONS[slug];
+ if (requiredEnvVars !== undefined) {
+ if (
+ item.dependencies !== undefined ||
+ !requiredEnvVars.every((envVar) => envVar in (item.envVars ?? {}))
+ ) {
+ throw new Error(
+ `Registry item "${item.name}" must declare its API key credentials without Vercel Connect.`,
+ );
+ }
+ break;
+ }
if (!item.dependencies?.includes("@vercel/connect")) {
throw new Error(`Registry item "${item.name}" must depend on @vercel/connect.`);
}
diff --git a/packages/eve-catalog/src/index.ts b/packages/eve-catalog/src/index.ts
index 648e97f88..288ff3f95 100644
--- a/packages/eve-catalog/src/index.ts
+++ b/packages/eve-catalog/src/index.ts
@@ -591,6 +591,17 @@ export const INTEGRATIONS: readonly IntegrationEntry[] = [
mcp: { url: "https://tellme.embat.io/mcp" },
},
},
+ {
+ slug: "firecrawl",
+ name: "Firecrawl",
+ kind: "connection",
+ tagline: "Search, scrape, map, crawl, parse, and monitor web content.",
+ surfaces: { scaffoldable: false, registry: true, gallery: true },
+ connection: {
+ description: "Firecrawl: search, scrape, map, crawl, parse, and monitor web content.",
+ mcp: { url: "https://mcp.firecrawl.dev/v2/mcp" },
+ },
+ },
{
slug: "hugging-face",
name: "Hugging Face",