AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mission is to provide the tools, so that you can focus on what matters.
feat(platform): add OpenSEO MCP, including self-hosted instances (#14971)
Nicholas Tindleaae418cb8be1
diff --git a/autogpt_platform/backend/backend/integrations/mcp_catalog.json b/autogpt_platform/backend/backend/integrations/mcp_catalog.jsonindex 98d542ed16..611ae8f164 100644--- a/autogpt_platform/backend/backend/integrations/mcp_catalog.json+++ b/autogpt_platform/backend/backend/integrations/mcp_catalog.json@@ -816,6 +816,23 @@"provider": "notion"}},+ {+ "name": "mcp_openseo",+ "display_name": "OpenSEO",+ "description": "Research keywords, SERPs, backlinks and competitor domains, run site audits, track rankings, and build SEO reports.",+ "mcp_server": {+ "server_url": "https://app.openseo.so/mcp",+ "documentation_url": "https://openseo.so/docs/mcp",+ "setup_instructions": "Sign in to OpenSEO, or use an OpenSEO API key. OpenSEO's cloud service requires an active subscription; keyword, SERP, backlink, local SEO and rank tracking tools spend OpenSEO credits. Self-hosting OpenSEO on Cloudflare? Replace the server URL with your instance's /mcp URL and sign in; turn on Managed OAuth in its Cloudflare Access application first.",+ "connection_mode": "hosted",+ "allow_custom_url": true,+ "auth_methods": [+ "oauth",+ "bearer"+ ],+ "icon_id": "openseo"+ }+ },{"name": "mcp_opsera","display_name": "Opsera",diff --git a/autogpt_platform/backend/backend/integrations/mcp_catalog.py b/autogpt_platform/backend/backend/integrations/mcp_catalog.pyindex 75dfa7481f..a7d25b4087 100644--- a/autogpt_platform/backend/backend/integrations/mcp_catalog.py+++ b/autogpt_platform/backend/backend/integrations/mcp_catalog.py@@ -32,6 +32,12 @@ class MCPServerMetadata(BaseModel):min_length=1)server_url_options: list[MCPServerURLPreset] = Field(default_factory=list)+ allow_custom_url: bool = Field(+ default=False,+ description="Hosted entries only: server_url stays the default, and "+ "users may replace it with their own endpoint, such as a self-hosted "+ "instance of the service.",+ )oauth_server_url: str | None = Noneoauth_scopes: list[str] | None = Noneoauth_write_scopes: list[str] = Field(default_factory=list)@@ -79,6 +85,8 @@ class MCPServerMetadata(BaseModel):raise ValueError("Hosted entries require a URL")elif self.server_url is not None:raise ValueError("Custom entries cannot prefill a URL")+ elif self.allow_custom_url:+ raise ValueError("Only hosted entries can allow a custom URL")if len(set(self.auth_methods)) != len(self.auth_methods):raise ValueError("Authentication methods must be unique")if self.oauth_write_scopes and self.oauth_scopes is None:diff --git a/autogpt_platform/backend/backend/integrations/mcp_catalog_test.py b/autogpt_platform/backend/backend/integrations/mcp_catalog_test.pyindex 68ef4be0ad..3fd717a8ba 100644--- a/autogpt_platform/backend/backend/integrations/mcp_catalog_test.py+++ b/autogpt_platform/backend/backend/integrations/mcp_catalog_test.py@@ -28,6 +28,7 @@ def test_posthog_catalog_entry_uses_hosted_authentication():assert entry.display_name == "PostHog"assert entry.mcp_server.icon_id == "posthog"assert entry.mcp_server.connection_mode == "hosted"+ assert entry.mcp_server.allow_custom_url is Falseassert entry.mcp_server.auth_methods == ["oauth", "bearer"]assert (entry.mcp_server.documentation_url@@ -35,6 +36,20 @@ def test_posthog_catalog_entry_uses_hosted_authentication():)+def test_openseo_catalog_entry_defaults_to_cloud_and_allows_self_hosting():+ entry = get_mcp_catalog_entry_for_url("https://app.openseo.so/mcp")++ assert entry is not None+ assert entry.name == "mcp_openseo"+ assert entry.display_name == "OpenSEO"+ assert entry.mcp_server.icon_id == "openseo"+ assert entry.mcp_server.connection_mode == "hosted"+ assert entry.mcp_server.server_url == "https://app.openseo.so/mcp"+ assert entry.mcp_server.allow_custom_url is True+ assert entry.mcp_server.auth_methods == ["oauth", "bearer"]+ assert entry.mcp_server.documentation_url == "https://openseo.so/docs/mcp"++@pytest.mark.parametrize("url",[@@ -63,9 +78,12 @@ def test_catalog_rejects_unsafe_urls(url: str, field: str):[{"server_url": None},{"connection_mode": "custom"},+ {"server_url": None, "connection_mode": "custom", "allow_custom_url": True},],)-def test_catalog_rejects_misleading_connection_modes(changes: dict[str, str | None]):+def test_catalog_rejects_misleading_connection_modes(+ changes: dict[str, str | bool | None],+):data = get_mcp_catalog()[0].mcp_server.model_dump()data.update(changes)with pytest.raises(ValidationError):diff --git a/autogpt_platform/frontend/public/integrations/README.md b/autogpt_platform/frontend/public/integrations/README.mdindex 54d5db46fd..299a2c579e 100644--- a/autogpt_platform/frontend/public/integrations/README.md+++ b/autogpt_platform/frontend/public/integrations/README.md@@ -11,6 +11,7 @@ The generic `database.png` and `generic_webhook.png` icons are rendered from `Da| `compass.png` | [Fieldy app icon](https://www.fieldy.ai/apple-touch-icon.png); the former Compass Wearable domain redirects to Fieldy || `dataforb2b.png` | [DataForB2B favicon](https://dataforb2b.ai/asset/favicon-192x192.png) || `elevenlabs.png` | [ElevenLabs app icon](https://elevenlabs.io/apple-icon.png) |+| `openseo.png` | [OpenSEO app icon](https://github.com/every-app/open-seo/blob/0ffff93101043aad7600a3b6a499a0cd2887ef49/public/apple-touch-icon.png), served at [openseo.so](https://openseo.so) || `posthog.png` | [PostHog brand logomark](https://github.com/PostHog/posthog.com/blob/master/static/brand/posthog-logomark%402x.png) || `rmfg.png` | [RMFG app icon](https://rmfg.com/apple-icon.png) || `stripe_link.png` | [Link app icon](https://images.stripeassets.com/fzn2n1nzq965/35yClx6UuTze6h851WsJqW/18da88ac03bd96140d16bdac62b94578/app-icon.png), linked from [link.com](https://www.link.com) |diff --git a/autogpt_platform/frontend/public/integrations/openseo.png b/autogpt_platform/frontend/public/integrations/openseo.pngnew file mode 100644index 0000000000..fe3bb8c96bBinary files /dev/null and b/autogpt_platform/frontend/public/integrations/openseo.png differdiff --git a/autogpt_platform/frontend/src/app/(platform)/settings/integrations/__tests__/mcp-catalog.test.tsx b/autogpt_platform/frontend/src/app/(platform)/settings/integrations/__tests__/mcp-catalog.test.tsxindex 0f1eb53a76..6f17ee5de3 100644--- a/autogpt_platform/frontend/src/app/(platform)/settings/integrations/__tests__/mcp-catalog.test.tsx+++ b/autogpt_platform/frontend/src/app/(platform)/settings/integrations/__tests__/mcp-catalog.test.tsx@@ -81,6 +81,39 @@ describe("SettingsIntegrationsPage — MCP catalogue", () => {).toBeDefined();});+ test("opens OpenSEO on its cloud server and lets self-hosters change the URL", async () => {+ const catalog: ProviderMetadata[] = JSON.parse(+ readFileSync(+ resolve("../backend/backend/integrations/mcp_catalog.json"),+ "utf8",+ ),+ );+ const openseo = catalog.find((entry) => entry.name === "mcp_openseo");+ expect(openseo).toBeDefined();+ server.use(getGetV1ListProvidersMockHandler([openseo!]));++ render(<SettingsIntegrationsPage />);+ const row = await screen.findByRole("button", { name: /openseo.*mcp/i });+ expect(within(row).queryByText("Setup required")).toBeNull();+ fireEvent.click(row);++ const dialog = await screen.findByRole("dialog");+ const input =+ await within(dialog).findByLabelText<HTMLInputElement>("Server URL");+ expect(input.value).toBe("https://app.openseo.so/mcp");+ expect(input.readOnly).toBe(false);+ fireEvent.change(input, {+ target: { value: "https://openseo.example.workers.dev/mcp" },+ });+ expect(input.value).toBe("https://openseo.example.workers.dev/mcp");+ fireEvent.click(within(dialog).getByRole("button", { name: /^connect$/i }));+ await waitFor(() => {+ expect(oauthRequest).toHaveBeenCalledWith({+ server_url: "https://openseo.example.workers.dev/mcp",+ });+ });+ });+test("lists native providers and branded MCP entries together", async () => {render(<SettingsIntegrationsPage />);expect(diff --git a/autogpt_platform/frontend/src/app/api/openapi.json b/autogpt_platform/frontend/src/app/api/openapi.jsonindex 782655882d..2f87b50594 100644--- a/autogpt_platform/frontend/src/app/api/openapi.json+++ b/autogpt_platform/frontend/src/app/api/openapi.json@@ -25503,6 +25503,12 @@"type": "array","title": "Server Url Options"},+ "allow_custom_url": {+ "type": "boolean",+ "title": "Allow Custom Url",+ "description": "Hosted entries only: server_url stays the default, and users may replace it with their own endpoint, such as a self-hosted instance of the service.",+ "default": false+ },"oauth_server_url": {"anyOf": [{ "type": "string" }, { "type": "null" }],"title": "Oauth Server Url"diff --git a/autogpt_platform/frontend/src/components/contextual/IntegrationsPanel/components/ConnectServiceDialog/components/DetailView/MCPPresetPanel.tsx b/autogpt_platform/frontend/src/components/contextual/IntegrationsPanel/components/ConnectServiceDialog/components/DetailView/MCPPresetPanel.tsxindex 8202e052eb..e97cf49e2b 100644--- a/autogpt_platform/frontend/src/components/contextual/IntegrationsPanel/components/ConnectServiceDialog/components/DetailView/MCPPresetPanel.tsx+++ b/autogpt_platform/frontend/src/components/contextual/IntegrationsPanel/components/ConnectServiceDialog/components/DetailView/MCPPresetPanel.tsx@@ -87,7 +87,9 @@ function PresetMethod({server.server_url ??""}- lockServerURL={server.connection_mode === "hosted"}+ lockServerURL={+ server.connection_mode === "hosted" && !server.allow_custom_url+ }allowedAuthMethods={[method]}oauthScopes={server.oauth_scopes}oauthWriteScopes={server.oauth_write_scopes}diff --git a/docs/platform/contributing/hosted-mcp-catalog.md b/docs/platform/contributing/hosted-mcp-catalog.mdindex f1d9748afc..7d295cee1c 100644--- a/docs/platform/contributing/hosted-mcp-catalog.md+++ b/docs/platform/contributing/hosted-mcp-catalog.md@@ -6,11 +6,22 @@- Keep a stable `mcp_...` ID and link directly to the vendor's setup documentation.- Describe the server's purpose and required plan, admin approval, region, endpoint, and credentials in `description` and `setup_instructions`.-- Use `connection_mode: hosted` with a fixed public HTTPS `server_url`, or `custom` for a user-provided endpoint. Add `server_url_options` for documented regions.+- Choose the connection setup that matches the vendor's server; see [Choose how users connect](#choose-how-users-connect).- Order the supported `auth_methods` by preference; the first method is selected initially. Choices are `oauth`, `bearer`, `basic`, and `none`.- Set `oauth_server_url` when the vendor supplies a separate signed-in endpoint.- Set documented `oauth_scopes` for the initial grant and separate `oauth_write_scopes` for the optional **Allow changes** choice. An empty default list omits the scope parameter; omission/null uses discovery defaults.+## Choose how users connect++Match the entry to where the vendor runs its MCP server. Every URL must be a public HTTPS URL.++- **One public URL for every customer:** use `connection_mode: hosted` with `server_url`. The connect dialog shows the URL locked, and AutoPilot uses it. Examples: PostHog, Notion.+- **One public URL, and the service can also be self-hosted:** use `hosted` with `server_url` and `allow_custom_url: true`. The dialog opens on `server_url`, and users can replace it with their own instance's URL. AutoPilot still uses `server_url`. Say in `setup_instructions` how to connect a self-hosted instance, including any sign-in setup it needs. Example: OpenSEO.+- **A separate URL per region:** use `connection_mode: custom` with one `server_url_options` entry per region and no `server_url`. Users pick their region, and the picker's **Custom URL** option covers self-hosted instances. Prefer this to one entry per region. Don't make it a hosted entry that defaults to one region, because users in the other regions would connect to the wrong one. Examples: Amplitude, Langfuse.+- **A URL unique to each customer account:** use `connection_mode: custom` with no `server_url` and no options. Say in `setup_instructions` where users find their URL. The dialog opens with an empty URL field. Examples: Chargebee, Sourcegraph.++Both `custom` setups show **Setup required** in the integrations list. AutoPilot tells users to add their URL under Settings → Integrations before it can use the server.+## Validate the changeCheck the vendor's current endpoint and authentication contract. Verify initialization and tool listing with the MCP client, then a benign read using the intended permissions. For OAuth, check registration, consent, and refresh with the deployment's callback and an authorized test account.