Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

{
  "mcpServers": {
    "fine-structure": {
      "type": "http",
      "url": "https://finestructure.ai/api/mcp"
    }
  }
}

claude mcp add --transport http fine-structure https://finestructure.ai/api/mcp

[mcp_servers.fine-structure]
url = "https://finestructure.ai/api/mcp"

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "fine-structure": {
      "type": "remote",
      "url": "https://finestructure.ai/api/mcp",
      "enabled": true
    }
  }
}

{
  "mcpServers": {
    "fine-structure": {
      "type": "http",
      "url": "https://finestructure.ai/api/mcp"
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=fine-structure&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vZmluZXN0cnVjdHVyZS5haS9hcGkvbWNwIn0%3D"
}

{
  "servers": {
    "fine-structure": {
      "type": "http",
      "url": "https://finestructure.ai/api/mcp"
    }
  }
}

{
  "mcpServers": {
    "fine-structure": {
      "httpUrl": "https://finestructure.ai/api/mcp"
    }
  }
}

extensions:
  "fine-structure":
    enabled: true
    name: "fine-structure"
    type: streamable_http
    uri: "https://finestructure.ai/api/mcp"
    timeout: 300

Quality 69 / 100needs work

protocol75 · weight 25

warn
protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
n/a
protocol.statelessonly applies to 2026-07-28 servers
pass
protocol.transportstreamable HTTP
n/a
protocol.list_ttlonly applies to 2026-07-28 servers

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygiene86 · weight 30

pass
tools.descriptionsevery tool has a description
pass
tools.description_lengthdescriptions are concise
pass
tools.schemasevery tool has an object input schema
pass
tools.annotations99 of 99 tools declare readOnlyHint or destructiveHint
pass
tools.directory_hintsevery tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
warn
tools.token_costabout 16,585 tokens to load every tool
warn
tools.api_dump99 tools, 65% named like REST operations: looks like an API mapped one endpoint per tool

stability25 · weight 15

warn
stability.changes22 tool changes in 30 days
fail
stability.rug_pull1 tools kept their name but changed most of their description in 30 days; review before trusting them

dependenciesn/a · weight 15

n/a
deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

99 tools, about 16,585 tokens to load them all · tool set 71dbc0ec4ea9 · tools last changed 2026-10-19 · checked 2026-10-20 14:54 UTC

Tool changes

2026-10-19set_agent_owner_relayadded
Set the owner's consent for one owned agent to relay reports from another owned agent (or all sources with '*'). Uses the same preference as the agent screen. Does not send a message or grant access to customer conversations.
2026-10-19preview_saved_versionadded
Prepare an isolated read-only Saved Version preview, if enabled by the deployment. Returns compiled files for an offline sandbox, never restores files or reads live records. Never execute the returned program with host credentials. Requires app access and versions:read.
2026-10-14get_platform_guidechangedinput schema
2026-10-14list_appschangeddescription
before
List applications owned by the authenticated user, newest activity first. Returns up to `limit` apps per call plus the total count; page with `offset` when the account has more.
after · 52% of words in common
List owned and accepted Studio-shared applications, newest activity first. Returns up to `limit` apps per call plus the total count; page with `offset` when the account has more. Accepted editors can edit shared source; viewers can read it. Publishing, records, domains and security administration remain owner-only.
2026-10-13get_agent_taskadded
Check a durable task returned by send_agent_message or list_agent_tasks. Includes the latest execution status and pending approvals, including before a run starts. Task scheduling state is separate from run outcome. Read the conversation for the actual answer; accepted/queued is not completed. Approvals must still be decided by the owner in Fine Structure.
2026-10-13get_agent_conversationadded
Read visible messages, answers and result links in an owned agent's conversation. Returns the newest page in chronological order. For older history, pass next_before_id as before_id. For new replies, omit before_id.
2026-10-13send_agent_messageadded
Talk to an existing agent or assign it work using its normal tools, memory, permissions and team. Omit conversation_id to start a new owner conversation; supply it to continue one. Returns acceptance and a durable task_id immediately, NOT a completed answer. Poll get_agent_task and read get_agent_conversation for the actual response. Work continues after MCP disconnects. A follow-up in a busy conversation uses the normal queue. Customer conversations are readable but cannot be impersonated by this tool.
2026-10-13list_agent_conversationsadded
List recent visible conversations belonging to one of your agents. Use get_agent_conversation to read replies and results.
2026-10-04set_app_metadataadded
Update public HTML-shell metadata immediately, without AI, code edits, publishing or Saved Versions. Upload social_image/icon as base64 PNG/JPEG/WebP (max 5 MB, 4096px); null clears an image. Language sets HTML lang/dir and OG locale. For per-page cards, write optional seo.json and publish it; dynamic entries may read only explicitly public entity records.
2026-10-04get_app_metadataadded
Read the saved public HTML-shell identity: name, description, language and image URLs/dimensions. Same settings as Studio SEO/GEO.

Showing the latest 10. Full history: list_changes · trend: quality JSON.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 79 / 100

no-repository

provenance55

liveness99

freshness85

hygiene80

+dns-namespace +website +reachable +uptime-97% ~updated-64d-ago -no-repository

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remote	auth	reachable	uptime 30d	p50	protocol	last ok
`https://finestructure.ai/api/mcp` streamable-http	none	yes	97%	295 ms	2025-11-25	2026-10-20

Tools (99)

`add_custom_domain`destructive	Attach or replace the app custom domain through the same Fine Structure Studio custom-domain flow. Returns exact DNS verification and routing records for the user to configure at their DNS provider.
`add_file_change`	Stage one file upsert or delete inside a change set. Does not modify the live app until apply_change_set. Paths follow the Fine Structure app file API, documented at https://finestructure.ai/api/mcp/docs.
`agency_create_claim_link`	Agency mode only. Create a client claim link for an existing app owned by the agent. The client must log in with the invited email before ownership transfers.
`agency_create_client`	Agency mode only. Create or update a client record for an account-level agent. This does not create a verified Fine Structure user account and does not transfer ownership.
`agency_create_client_app`	Agency mode only. Create a new app owned by the agent, start generation, and create a claim link for the client. Ownership transfers only when the invited client logs in with the same email and accepts the claim link.
`agency_get_claim_status`read-only	Agency mode only. Inspect one handoff status without exposing the raw claim token.
`agency_list_clients`read-only	Agency mode only. List client records and app handoff status for the authenticated agent.
`apply_change_set`	Apply a staged change set to the app. Creates a Saved Version before applying. Blocks on validation errors unless force=true.
`attach_agent_whatsapp`	Connect a platform WhatsApp number to one of the account's agents, so the owner can message that number and reach that agent. Requires the owner to be verified first. Take phone_number_id from get_agent_whatsapp. A number already used by another account is still valid to connect: it answers only this owner's verified phone.
`check_domain_verification`	Check Fine Structure custom-domain verification and SSL status for the configured custom domain, then save the latest status.
`check_subdomain_available`read-only	Check whether a platform subdomain can be claimed before calling set_app_subdomain. Returns available plus a status of available, invalid, reserved, taken, current, or empty, with the exact reason. Pass app_id (an app you own) to have that app's own current subdomain reported as 'current' instead of 'taken'.
`compare_current_to_version`read-only	Compare the current app files to a Saved Version and return compact per-file diffs.
`compare_saved_versions`read-only	Compare two Saved Versions and return per-file additions, removals, modifications, and compact diffs.
`configure_domain_redirects`	Configure custom-domain redirect policy: primary domain, optional www/root redirect, and HTTPS enforcement.
`configure_integration`	Store safe non-secret integration metadata for an app. Use set_secret for API keys/tokens.
`confirm_owner_phone_verification`	Confirm the 6-digit code the owner received on WhatsApp from start_owner_phone_verification. On success the owner is verified: agents can message them, and platform numbers become connectable.
`create_ab_test`	Create a native Fine Structure A/B test between existing app pages. Use update_app first if a variant page still needs to be generated. Creates a Saved Version before the change.
`create_agent`	Create an autonomous AI agent on the user's Fine Structure account: a standing worker, not a chat session. It gets the platform's default safe tool policy and its own email address, it can read and write the app database, and once the owner phone is verified (see get_agent_whatsapp) it can message its owner on WhatsApp and by email through the platform system channels. Pair it with schedule_agent_task for recurring work such as following up new leads on WhatsApp each morning, watching an app for runtime errors, or sending a weekly summary. Messaging anyone other than the verified owner requires a channel the owner connects in the Fine Structure Studio.
`create_app`	Create a new application from a natural language prompt. The AI generates a complete web app with pages, components, styling, and data models. Returns a job_id - poll get_job_status to track progress. When the job is done, the app is ready.
`create_change_set`	Create a staged file change set. Add multiple file changes, validate them as one app state, then apply atomically.
`create_entity_records`	Create/insert records in one app entity. Executes directly for the authenticated app owner and returns the created record ids.
`create_entity_schema`	Create an entity schema file in entities/<Entity>.json. Creates a Saved Version before writing.
`create_platform_request`	Open a request to the Fine Structure platform team: a bug, a feature request or a question about the platform itself (not about the user's app). Use it when something in the platform blocks you instead of working around it. Give a reproduction the team can run (invoke_function / curl / the exact tool call and result), what you expected, and how the team will know it is closed. Credential-looking values are redacted. Returns request_id and a Studio URL; the team's replies, status changes and deployments come back through get_platform_request / list_platform_requests. Limits: 20 per account per day, 32 KB.
`delete_ab_test`destructive	Delete a native A/B test from an app. Creates a Saved Version before the change.
`delete_entity_records`destructive	Delete exact records by ID or exact-match filters. Executes directly for the authenticated app owner; pass expected_count as a safety check to abort on a mismatch.
`delete_secret`destructive	Delete one app secret by key.
`detach_agent_whatsapp`destructive	Disconnect the owner's WhatsApp route from a platform number. Removes only this account's route; other accounts sharing the number keep theirs.
`discard_change_set`destructive	Discard a pending staged change set without changing app files.
`get_ab_test_stats`read-only	Get views, unique visitors, conversions, and conversion rates for an A/B test.
`get_agent_conversation`read-only	Read visible messages, answers and result links in an owned agent's conversation. Returns the newest page in chronological order. For older history, pass next_before_id as before_id. For new replies, omit before_id.
`get_agent_task`read-only	Check a durable task returned by send_agent_message or list_agent_tasks. Includes the latest execution status and pending approvals, including before a run starts. Task scheduling state is separate from run outcome. Read the conversation for the actual answer; accepted/queued is not completed. Approvals must still be decided by the owner in Fine Structure.
`get_agent_whatsapp`read-only	Read the WhatsApp state of the connected account: whether the owner's phone is verified, which platform numbers they can connect, and which conversations already route to which agent. Call this first whenever the user asks to talk to an agent on WhatsApp, and repeat its next_step to them.
`get_app_analytics`read-only	Traffic analytics for an app's published site over a chosen window: total views, unique visitors, daily series, top pages, top referrer domains and device split.
`get_app_detail`read-only	Deep introspection of an app: entities, pages, settings, integrations, environment variables, and file structure. Use this to understand what an app contains before updating it.
`get_app_files`read-only	Get the file tree for an app with paths and byte sizes.
`get_app_links`read-only	Return editor, preview, published path, subdomain, and custom-domain links plus whether each works for anonymous visitors, app users, or Studio users based on publish and auth settings.
`get_app_metadata`read-only	Read the saved public HTML-shell identity: name, description, language and image URLs/dimensions. Same settings as Studio SEO/GEO.
`get_app_security_audit`read-only	Read recent server-side security audit events for an app.
`get_app_security_context`read-only	Return safe security context for one owned app: owner id/email, Studio collaborators, generated-app members, route policies, entity policies, function policies, and recent security audit entries. Does not return secrets and does not grant access to other apps.
`get_app_status`read-only	Get app overview: files, published state, URL, active jobs.
`get_domain_ssl_status`read-only	Return SSL/certificate status and pending certificate validation DNS records for the app custom domain.
`get_domain_verification`read-only	Return the exact DNS records and instructions required to verify and route the app custom domain.
`get_entities`read-only	Get all entity (data model) schemas for an app, with record counts. Each entity has fields, types, and relationships.
`get_errors`read-only	Get recent runtime errors for an app (last 20). Useful for diagnosing issues before updating.
`get_job_status`read-only	Poll the status of an async generation job. Use this after create_app or update_app to know when the job is done. Returns status ('running' or 'done'), progress events, and result summary when complete.
`get_pages`read-only	Get all pages in an app with their file paths and sizes.
`get_platform_guide`read-only	Return a machine-readable Fine Structure / FSe2 guide for AI agents. Call this at the start of an MCP session to learn app files, entities, safe edit workflows, validation, publishing, A/B testing, secrets, and platform rules.
`get_platform_request`read-only	One platform request with its full history: team replies, status changes (open \| triaged \| in_progress \| needs_info \| deployed \| wont_fix) and what was deployed (commit, time). Pass since=<ISO timestamp> to get only the events after it.
`get_preview_url`read-only	Return editor preview and published/public URLs for an app.
`get_recommended_workflow`read-only	Return the recommended MCP tool sequence for a task type. Use this before creating apps, editing files, seeding data, publishing, setting up A/B tests, restoring versions, or configuring secrets/integrations.
`inspect_preview`read-only	Return server-side preview context: URLs, persisted runtime/network errors, static clickable candidates, pages, and explicit live-browser availability.
`invite_app_member`	Provision a generated-app runtime member with a role. This does not create a Studio collaborator, and the owner role cannot be assigned. password is required: ask the account owner which password the member should get. This tool never generates one, because a generated password would come back in the result and that is a live credential in the conversation transcript.
`invoke_function`	Run a backend function of an owned app exactly like the HTTP route and return its status and JSON. caller='owner' runs as the app owner; caller='anonymous' first evaluates the function policy as a public visitor and returns the 401/403 decision without running when access would be denied. Use it to verify a function (secrets, outbound calls, policy) before wiring it into the app.
`list_ab_tests`read-only	List the platform A/B tests configured for an app.
`list_agent_conversations`read-only	List recent visible conversations belonging to one of your agents. Use get_agent_conversation to read replies and results.
`list_agents`read-only	List the AI agents on the user's account with id, name, role, status and FineMail address.
`list_agent_tasks`read-only	List scheduled tasks for one agent (or the whole account), including schedule, status and next_run_at.
`list_app_domains`read-only	List an app's platform path, subdomain, and configured custom domain with verification, SSL, primary-domain, redirect, publish, and login-gating status.
`list_app_members`read-only	List generated-app runtime users/members for an app. This is separate from Studio project collaborators.
`list_apps`read-only	List owned and accepted Studio-shared applications, newest activity first. Returns up to `limit` apps per call plus the total count; page with `offset` when the account has more. Accepted editors can edit shared source; viewers can read it. Publishing, records, domains and security administration remain owner-only.
`list_integrations`read-only	List supported integrations and safe connected integration metadata for an app. Tokens/secrets are never returned.
`list_platform_requests`read-only	Your account's platform requests, newest activity first. Call it at the start of a session with since=<the updated_date you last saw> to learn what changed: replies, needs_info questions to answer, deployments with their commit. Filters: app_id, status.
`list_saved_versions`read-only	List restorable Saved Versions for an app, including versions created by MCP writes.
`list_secret_keys`read-only	List secret key names for an app. Secret values are never returned.
`patch_app_file`	Patch one file by replacing exact text. Safer than full overwrite for targeted edits. Creates a Saved Version before changing content. Paths follow the Fine Structure app file API, documented at https://finestructure.ai/api/mcp/docs.
`preview_saved_version`read-only	Prepare an isolated read-only Saved Version preview, if enabled by the deployment. Returns compiled files for an offline sandbox, never restores files or reads live records. Never execute the returned program with host credentials. Requires app access and versions:read.
`publish_app`	Publish an app - freeze current state and make it live at a URL. Also configures whether the public URL is open, app-login gated, private, or inferred from the app.
`query_entity`read-only	Query app data records for one entity with optional exact-match filters.
`read_app_file`read-only	Read one source file from an app's virtual filesystem. Paths follow the Fine Structure app file API, documented at https://finestructure.ai/api/mcp/docs.
`read_app_files`read-only	Read several source files from an app's virtual filesystem. Paths follow the Fine Structure app file API, documented at https://finestructure.ai/api/mcp/docs.
`remove_app_member`destructive	Remove a generated-app runtime member.
`remove_custom_domain`destructive	Remove the configured custom domain from the app and clean up the platform-side hostname registration when possible.
`rename_app_file`	Rename or move one app source file atomically. Internally stages an upsert at new_path and a delete at old_path, validates the resulting app state, and creates a Saved Version before applying.
`reply_platform_request`	Add a reply or a finding to one of your platform requests without opening a new one, e.g. to answer a needs_info question (that reopens it).
`restore_file_from_version`destructive	Restore one file from a Saved Version instead of restoring the entire app. Creates a Saved Version before changing the file. Paths follow the Fine Structure app file API, documented at https://finestructure.ai/api/mcp/docs.
`schedule_agent_task`	Create a scheduled task for one of the user's agents. Supported schedule types: once (run_at ISO local time + timezone), interval (interval_minutes 5-1440), hourly, daily (time HH:MM + timezone), weekly (time + timezone + days_of_week 0=Sunday..6), cron (5-field expression + timezone), manual (only runs on demand). Returns the normalized schedule and the computed next_run_at so you can read the fire time back to the user in their timezone.
`seed_entity`	Compatibility tool for starter-record creation. Inserts directly for the authenticated app owner; by default it only seeds an empty entity (skip_if_not_empty).
`send_agent_message`destructive	Talk to an existing agent or assign it work using its normal tools, memory, permissions and team. Omit conversation_id to start a new owner conversation; supply it to continue one. Returns acceptance and a durable task_id immediately, NOT a completed answer. Poll get_agent_task and read get_agent_conversation for the actual response. Work continues after MCP disconnects. A follow-up in a busy conversation uses the normal queue. Customer conversations are readable but cannot be impersonated by this tool.
`set_agent_owner_relay`	Set the owner's consent for one owned agent to relay reports from another owned agent (or all sources with '*'). Uses the same preference as the agent screen. Does not send a message or grant access to customer conversations.
`set_app_metadata`	Update public HTML-shell metadata immediately, without AI, code edits, publishing or Saved Versions. Upload social_image/icon as base64 PNG/JPEG/WebP (max 5 MB, 4096px); null clears an image. Language sets HTML lang/dir and OG locale. For per-page cards, write optional seo.json and publish it; dynamic entries may read only explicitly public entity records.
`set_app_subdomain`destructive	Set or clear the app platform subdomain - the '<subdomain>.<base domain>' host Fine Structure already serves the app on. Runs the same ownership, format, reserved-name and uniqueness checks as the Studio subdomain field because it calls the same model function. Replacing a subdomain takes effect immediately and creates NO redirect: the previous name stops resolving to this app and is released for anyone to claim. Pass an empty subdomain to clear it. For a domain the user owns, use add_custom_domain instead.
`set_entity_policy`destructive	Replace server-side entity access policy. Optional action rules override read/write roles and can allow public create without public read, update, or delete. Omitting rules replaces any existing action rules with read/write role behavior.
`set_function_policy`	Create or update the server-owned access policy of a backend function (functions/<name>.js). Without a policy a function answers only to the app owner's Studio token (401 for app visitors and webhooks). Recipes: anonymous checkout step or inbound webhook/IPN -> require_auth=false; signed-in members -> require_auth=true + allowed_roles (e.g. ['authenticated'] or ['admin','staff']); webhook with a shared secret -> require_secret=true + secret_name (an app secret) that the caller sends in secret_header. allowed_hosts fences the function's outbound network to those hosts plus the platform backend; omit it for open egress.
`set_primary_domain`	Set which app host should be treated as primary for generated links and custom-domain redirects.
`set_route_policy`destructive	Create or update a server-owned route policy for a generated app route.
`set_secret`destructive	Create or update one encrypted app secret. The secret value is never returned.
`start_owner_phone_verification`destructive	Send a 6-digit code over WhatsApp to the ACCOUNT OWNER's own phone. This is the one-time ownership proof required before a platform number can be connected, and it also unlocks agents messaging the owner. Ask the user for their own WhatsApp number first and send only to that. No WhatsApp Business account is involved.
`update_ab_test`	Update a native A/B test, including active state, variants, traffic, and conversion goal. Creates a Saved Version before the change.
`update_app`	Update an existing application with a new prompt. The AI modifies the app based on your instructions. Creates a Saved Version before the update. Returns a job_id - poll get_job_status to track progress.
`update_app_member_role`destructive	Update a generated-app runtime member role. This cannot assign owner and cannot change the Fine Structure account owner.
`update_entity_metadata`	Set relationship/index metadata on an entity schema. This stores metadata in the schema file; DB index creation is automatic where supported by the platform.
`update_entity_record`destructive	Compatibility tool that updates one record by ID. Executes directly for the authenticated app owner.
`update_entity_records`destructive	Update exact records. Select explicit record_ids or exact-match filters and provide shared changes, or provide per-record updates. Executes directly for the authenticated app owner; expected_count aborts the write on a mismatch.
`update_entity_schema`	Replace or shallow-merge an existing entity schema file. Creates a Saved Version before writing.
`update_platform_request`	Platform team only: set the status of a request (open \| triaged \| in_progress \| needs_info \| deployed \| wont_fix), attach the deployed commit and/or reply. deployed and needs_info mail the requester.
`validate_app`read-only	Run deterministic app checks: syntax, imports, routes/pages, entity schemas, missing entities, and recorded runtime errors.
`validate_change_set`read-only	Validate current app files plus staged change set files before applying.
`validate_entity_relationships`read-only	Validate entity relationship metadata and *_id references against existing entity schemas.
`write_app_file`	Create or replace one file in an app's virtual filesystem. Creates a Saved Version before changing content. Paths and file model follow the Fine Structure app file API, documented at https://finestructure.ai/api/mcp/docs.

Schemas: list_tools.

Similar MCP servers

Official server.json

{
  "name": "ai.finestructure/fine-structure",
  "title": "Fine Structure",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://finestructure.ai/api/mcp",
      "type": "streamable-http"
    }
  ],
  "version": "1.0.2",
  "websiteUrl": "https://finestructure.ai",
  "description": "Build and host full-stack apps from a prompt, with agents that reach you on WhatsApp and email."
}