The toolbelt
Every tool the agenthost MCP exposes, what it acts on, and where each group is documented in full.
Everything agenthost does is a tool call. There is no dashboard to fall back to and no REST API to
reach for — projects, apps, deploys, access and tokens are all driven through the MCP server at
https://agenthost.eu/mcp.
Three things hold for every tool on this page:
- Calls are scoped to one customer. A connection is authenticated as a person acting for a single
customer, and every tool reads and writes only that customer's data. Reaching a different customer
means authorizing again —
whoamiwill tell you which others the same person belongs to. - Signing in never happens here. Authentication is an OAuth flow in the browser; by the time a tool runs, the caller is already authenticated. No tool takes a password, and none returns one.
- The plan decides what you can create. Static sites, apps, private apps, custom domains and team members are all bounded by it, and on a paid plan some of them are billed as you add them. A refused call says which plan is in the way; a call that costs money says so in the result. See Plans & billing.
This page is the reference. If you want the task-shaped version — "how do I put an app online", "how do I make it private" — start at the how-to guides.
The groups
Account & users
Who you are acting as, and who else can act on this customer.
Plans & billing
What the account may create, what it costs, and how to change it.
Projects
The container everything else lives in.
Apps
Provision, deploy, inspect and tear down hosted apps.
App access
Who is allowed to open a deployed app.
Source uploads
Stream a large project to us instead of passing it inline.
GitHub
Build an app from a repository, and deploy it on every push.
Databases
Provision databases on demand and wire them into apps.
Services
The generic service record beneath an app.
API tokens
Long-lived credentials for clients that cannot open a browser.
Every tool at a glance
| Tool | Group | What it does |
|---|---|---|
whoami | Account | Show the user, customer and role this connection acts as |
invite_user | Account | Give another person control of this customer |
list_users | Account | List everyone with access to this customer |
get_plan | Plans | Show the plan, what it includes, and what is used |
list_plans | Plans | List every plan with its price and allowances |
upgrade_plan | Plans | Get a secure payment link for a paid plan |
manage_billing | Plans | Get a billing-portal link to switch, pay or cancel |
create_project | Projects | Create a project to group services |
list_projects | Projects | List the customer's projects |
get_project | Projects | Fetch one project by id |
rename_project | Projects | Change a project's display name |
delete_project | Projects | Delete a project and every service in it |
create_app | Apps | Provision an app, optionally deploying source in the same call |
deploy_app | Apps | Build and run new source for an existing app |
list_apps | Apps | List apps, optionally filtered to one project |
get_app | Apps | Fetch one app and refresh its live status |
get_app_logs | Apps | Read recent build and runtime output |
delete_app | Apps | Tear an app down and remove its data |
share_app | App access | Invite one person to open an app, making it invite-only |
set_app_access | App access | Switch an app between public and invite-only |
list_app_access | App access | Show an app's access mode and its invitees |
revoke_app_access | App access | Remove one person's access to an app |
begin_upload | Source uploads | Mint a one-time URL to stream a project archive to |
connect_github | GitHub | Get the link a customer opens to connect their GitHub account |
list_github_repos | GitHub | List the repositories agenthost may read |
link_repo | GitHub | Build an app from a repository branch, and deploy it |
deploy_from_repo | GitHub | Deploy the connected repository now, at any ref |
unlink_repo | GitHub | Stop building an app from its repository |
create_database | Databases | Provision a database on demand, optionally wiring it into an app |
attach_database | Databases | Wire a database into an app as an injected env var |
detach_database | Databases | Remove the link between an app and a database |
get_database | Databases | Fetch one database, its live status and dependent apps |
list_databases | Databases | List databases, optionally filtered to one project |
delete_database | Databases | Tear a database down and delete it |
create_service | Services | Create a generic service record inside a project |
list_services | Services | List services, optionally filtered to one project |
get_service | Services | Fetch one service, including its config |
update_service | Services | Patch a service's name, type, runtime, config or status |
delete_service | Services | Delete a service |
create_token | API tokens | Mint a long-lived bearer token |
list_tokens | API tokens | List your tokens, metadata only |
revoke_token | API tokens | Revoke a token by id |
Apps or services?
create_app is the one to reach for: it provisions and hosts, and it is what the
runtime reference documents. The *_service tools manage the generic record underneath —
useful for modelling something agenthost does not host yet, but they do not build or run anything.