Model Context Protocol (MCP) | Seenode Docs

Model Context Protocol (MCP)

Connect AI coding agents to seenode with the hosted MCP server. Deploy apps, manage databases, and operate your stack from Cursor, Claude Code, and more.

The seenode Model Context Protocol (MCP) server lets AI coding agents deploy and operate applications on seenode (web services, workers, managed databases, storage, domains, projects, and billing) without leaving your editor.

Server URL

https://mcp.seenode.com/mcp

Transport is Streamable HTTP. Authentication is OAuth 2.1 with PKCE against seenode. Do not put API keys or Authorization headers in MCP client config.

Connect to seenode’s MCP server

Click the button to add the seenode MCP server in Cursor, then complete OAuth when prompted.

Install in Cursor

Or add this to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

mcp.json
{
"mcpServers": {
"seenode": {
"url": "https://mcp.seenode.com/mcp"
}
}
}

Reload Cursor if needed, then complete the seenode OAuth consent when prompted.

Add the remote MCP server, then complete OAuth when prompted:

Terminal
claude mcp add --transport http seenode https://mcp.seenode.com/mcp

Click the button to add the seenode MCP server in VS Code, then complete OAuth when prompted.

Install in VS Code

Or add this to .vscode/mcp.json in your workspace:

mcp.json
{
"servers": {
"seenode": {
"type": "http",
"url": "https://mcp.seenode.com/mcp"
}
}
}

Complete OAuth when VS Code prompts you.

Create a custom connector with:

SettingValue
Server URLhttps://mcp.seenode.com/mcp
AuthOAuth

ChatGPT custom connectors require a Pro, Plus, Business, Enterprise, or Education account. Follow the OpenAI developer mode documentation.

Point your MCP client at:

SettingValue
Server URLhttps://mcp.seenode.com/mcp
TransportStreamable HTTP
AuthOAuth 2.1 + PKCE

Authorization is issued by https://api.seenode.com.

After you connect

  1. Sign in to a seenode account if you do not have one yet.
  2. Complete the OAuth consent when your client opens the browser.
  3. Smoke-test with a read-only prompt, for example:
    • “What is my current seenode team? Use get_current_team.”
    • “List my seenode web applications.”
  4. Only then run mutating flows (create app or database, set secrets, add domains, billing).

Enable human confirmation for mutating tools in your client when available.

Authentication

The MCP server uses OAuth so agents act as you on your seenode team, with browser consent, refresh tokens, and no long-lived secrets in plugin manifests.

DetailValue
Resourcehttps://mcp.seenode.com/mcp
Authorization serverhttps://api.seenode.com
Grant typesAuthorization code, refresh token
PKCES256 required

REST API keys (Getting an API Key) are for the HTTP API and CI. They are not used in the recommended MCP client configuration.

What you can do

Agents can:

  • Deploy a GitHub or GitLab repository as a web, worker, or private application
  • Create and link managed MySQL / PostgreSQL databases (without pasting passwords)
  • Inspect builds, wait on or cancel deployments, read logs and metrics
  • Manage environment variables, custom domains, projects, storage volumes, and billing/credits

Example prompts

  • “Deploy this repository to seenode as a web app.”
  • “Create a PostgreSQL database, wait until it’s ready, and link it to my app.”
  • “Why did my latest seenode deployment fail?”
  • “What’s my seenode credit balance in USD?”
  • “Add example.com to my seenode web app and show the DNS records.”

Tools

The hosted server exposes 60+ tools. Grouped by area:

Team and projects

ToolDescription
list_teamsList teams you belong to
get_current_teamTeam context for the OAuth session
get_team_limitsPlan / capacity limits
get_team_services_briefBrief inventory of team services
get_team_usageUsage summary
list_projects / get_project / get_project_resourcesProject grouping
create_project / update_projectCreate or update a project
assign_project_servicesAssign apps or databases to a project

Git and repository inspection

ToolDescription
get_git_connectionsConnected GitHub / GitLab providers
connect_git_providerStart provider OAuth; returns authorizationUrl
list_git_repositories / list_git_branchesDiscover repos and branches
inspect_repositoryBuild/run hints for a repo
list_imagesAvailable runtime images

Applications and deployments

ToolDescription
list_applications / get_applicationDiscover apps (web, worker, private)
create_application / update_applicationCreate or update an app
duplicate_application / restart_applicationClone settings or restart instances
list_application_packagesCapacity / package tiers
get_build_settings / update_build_settingsRuntime, commands, port, branch, root dir
get_deployments / create_deploymentList or trigger deploys
wait_for_deployment / cancel_deploymentWait for success/failure or cancel in-flight builds
get_application_logs / get_application_metricsRuntime diagnostics

Environment variables

ToolDescription
list_environment_variablesList keys (secrets masked)
set_environment_variablesSet values; mark secrets with secret_keys
reveal_environment_variablesReveal non-secret values when explicitly needed
delete_environment_variablesRemove keys (confirm for production)

Databases

ToolDescription
list_databases / get_database / get_database_stateInventory and readiness
list_database_packagesDatabase package tiers
create_database / update_databaseProvision or resize (mysql / postgresql)
link_database_to_applicationWire credentials as secret env vars (preferred)
rotate_database_user_passwordRotate password, then re-link with overwrite=true
get_database_metricsDatabase metrics

Storage

ToolDescription
list_storage_packages / list_application_storagePackages and attached volumes
create_application_storage / update_application_storageAttach or resize (scale must be 1)
get_application_storage_metricsVolume metrics

Domains

ToolDescription
list_domains / add_domain / update_domainCustom domains on web apps
check_domain_statusDNS / readiness (ready: true before claiming live)

Billing

ToolDescription
get_credit_balance / get_spending / get_bonus_credit_rateCredits and spend (USD fields)
list_billing_orders / list_credit_ledger / get_billing_informationOrders and ledger
get_billing_portal_url / create_checkout_session / create_setup_intentPortal and top-up flows
pay_nowCharge outstanding balance (confirm first)
Warning (Safety)

There are no delete/destroy tools for apps, databases, domains, projects, or storage via MCP (only delete_environment_variables). Tear those resources down in the dashboard. Prefer link_database_to_application over pasting database passwords into chat. Confirm before billing mutations.

Agent Plugin

The seenode Agent Plugin packages skills and client adapters for Cursor, Claude Code, and OpenAI / Codex on top of the same hosted MCP URL. Until marketplace plugins are published, install skills manually from that repo. See Agent Skills.