Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Fine Structure API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Ffinestructure.ai%2Ffinestructure" | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Ffinestructure.ai%2Ffinestructure" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Fine Structure API.
Create a web application from a natural-language prompt and update it with new prompts
Read, write, patch, and rename files in an app's virtual filesystem
Define and query data entities and create, update, or delete their records
Publish an app and manage its subdomain, custom domain, SSL, and redirects
Run an app's backend functions and set route, function, and entity access policies
GET STARTED
Create autonomous agents and schedule their tasks on your account
Patterns agents use Fine Structure API for, with concrete tasks.
★ Agent-built web apps through Jentic
An AI agent turns a brief into a working app: it calls create_app with a prompt, polls the generation job until it is done, reads the file tree, patches a page, then publishes. Because file reads, writes, and validation are separate operations, the agent can inspect and fix its own output before anything goes live.
Create an app from a prompt with create_app, poll get_job_status until done, then publish the app
Manage app data and backend logic
An app is more than its pages. Fine Structure exposes each app's data entities and lets an agent query records, create and update them, and run backend functions behind route and function policies, so an integration can seed starter data, wire up logic, and keep access rules server-owned rather than guessed in the frontend.
Query records from an entity, create a new record, and invoke a backend function to verify it responds
Publish and route a custom domain
Shipping an app means getting a domain live with SSL. The API publishes an app, sets its subdomain, attaches a custom domain, returns the DNS records to verify it, and reports SSL status, so a deployment workflow can take an app from generated to reachable on its own domain without the dashboard.
Publish an app, add a custom domain, and read the DNS and SSL verification status it returns
130 endpoints — the fine structure api builds and manages complete web applications from natural-language prompts.
METHOD
PATH
DESCRIPTION
/api/mcp/tools/create_app
Create an app from a natural-language prompt
/api/mcp/tools/update_app
Update an app with a new prompt
/api/mcp/tools/publish_app
Publish an app and make it live at a URL
/api/mcp/tools/write_app_file
Create or replace a file in an app
/api/mcp/tools/query_entity
Query records for one app entity
/api/mcp/tools/get_job_status
Poll an async generation job
/api/mcp/tools/create_agent
Create an autonomous agent on the account
/api/mcp/manifest
Tool discovery manifest with names and schemas
/api/mcp/tools/create_app
Create an app from a natural-language prompt
/api/mcp/tools/update_app
Update an app with a new prompt
/api/mcp/tools/publish_app
Publish an app and make it live at a URL
/api/mcp/tools/write_app_file
Create or replace a file in an app
/api/mcp/tools/query_entity
Query records for one app entity
/api/mcp/tools/get_job_status
Poll an async generation job
/api/mcp/tools/create_agent
Create an autonomous agent on the account
/api/mcp/manifest
What agents get from Jentic-routed access to this vendor.
Setup
Wiring the Fine Structure API by hand means handling its Bearer token, the asynchronous job polling for every generation, and the stage-validate-apply flow for file changes yourself. Through Jentic you install once, import it from the API Directory, store the token once, and your agent calls it.
Permission scoping
App ids travel in the request body, not the URL path, so rules bound which operations your agent may call rather than which app. You choose the operations it may call, so destructive ones like delete_entity_records, remove_custom_domain, or delete_secret stay out unless you add them.
Credential isolation
Your Fine Structure token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'build a web app from a prompt' or 'query an app entity', and Jentic returns the matching Fine Structure operation with its input schema so the agent calls the right endpoint without browsing the reference docs.
Alternatives and complements available in the Jentic catalogue.
Specific to using Fine Structure API through Jentic.
What authentication does the Fine Structure API use?
It uses a Bearer token sent in the Authorization header, per its OpenAPI spec. You create a token on your account and the same token scopes calls to the apps and agents you own, while a tool manifest and a health check are open.
Can I manage an app's data and files with the Fine Structure API?
Yes. You can read the file tree, read and write individual source files, and patch or rename them, and separately define data entities and query, create, update, or delete their records. Changes can be staged in a change set, validated, and applied, so an agent can check its edits before they land.
What are the rate limits for the Fine Structure API?
The OpenAPI spec does not state a request rate limit. Generation work is asynchronous and metered by your account plan, so create a job and poll its status rather than busy-waiting, and check the Fine Structure documentation for current limits.
Is there a Fine Structure MCP server?
Yes, Fine Structure exposes an MCP endpoint and a tool manifest. You can also connect Fine Structure directly through Jentic: your agent gets the full 130-endpoint surface without loading another server's tool definitions into its context, your token is injected at call time by your self-hosted instance instead of living in a config file, and your rules decide which operations the agent may call.
Can I limit what my agent is allowed to do with the Fine Structure API?
Yes. Write a rule that allows the read and edit operations your agent needs, such as reading files and querying entities, and leave the record-delete, secret, and domain-removal operations off the list, so an agent can build and inspect an app without removing data or rotating secrets. Every call it makes is recorded in your Jentic One audit log.
How do I build an app with the Fine Structure API through Jentic?
Search Jentic for 'build a web app from a prompt', add the Fine Structure API from the directory, and store your token once; your agent then creates the app, polls the generation job, edits files, and publishes. To run it on your own infrastructure, install Jentic One from its GitHub repo.
For Agents
Build and update web apps from prompts, edit their files and data entities, validate and apply change sets, publish and route custom domains, run backend functions, and operate autonomous agents.
Use for: Create a new web app from a prompt, Update an app with a new instruction, Read the file tree and open a source file in my app, Query records from one of my app's data entities
Not supported: Does not handle hosting of apps built outside the platform, standalone source-control, or general CI pipelines for external repos. Use for building, editing, and publishing Fine Structure web applications only.
The Fine Structure API builds and manages complete web applications from natural-language prompts. It creates and updates apps, reads and writes files in each app's virtual filesystem, defines and queries data entities, and stages file changes it can validate before applying. It publishes apps and manages their subdomains, custom domains, SSL, and redirects, runs backend functions behind access policies, and operates autonomous agents with scheduled tasks on your account. Generation work is asynchronous, so jobs are created and then polled for status.
This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.
Tool discovery manifest with names and schemas
Base layer of spec validity and structural soundness.
Aggregated quality score from linter diagnostics, weighted by severity.
Percentage of `$ref` references that resolve successfully.
Checks whether the API description parses successfully and conforms to its declared specification (e.g., OpenAPI).
Structural correctness score based on schema issues using logarithmic dampening.
Clarity, completeness, and ingestion readiness for developers and tooling.
How richly the API is illustrated with examples.
Percentage of examples that conform to their schemas.
Percentage of operations with complete response definitions (success, client error, server error).
Health of API ingestion, bundling, and resolution within Jentic pipelines.
Semantic breadth, depth, and agent comprehension for AI systems.
Coverage of descriptions across API elements.
Coverage of RFC 9457 Problem Details for error responses.
Coverage, uniqueness, and casing consistency of operationIds for AI inference.
Coverage of summaries across operations/tags/info.
Functional utility, complexity comfort, and AI orchestration readiness.
Agent comfort level based on API operational and structural complexity.
Trust, risk posture, and security compliance.
Average quality of security schemes based on authentication method strength (weakest link for OAuth2).
Findability, semantic richness, and reasoning readiness.
Clarity and depth of descriptions across API elements.
Score it yourself
Every API in the directory is allowlisted, so you can re-score it with no key required.
npx @jentic/api-scorecard-cli score <openapi-url>