Get started
Tell your assistant
Read getfinero.com/skill.md and connect me to FineroOr give it the MCP server directly
https://app.getfinero.com/mcpWorks with any assistant that speaks MCP, or any that can read a URL. There is nothing to install: Finero has no CLI, and the skill tells an agent what to do rather than running anything.
One thing has to happen first, and only an administrator can do it: switch on agent connections for the workspace, in Finero under Settings, then API and agents. It is off by default. Leave it off and the assistant will appear to connect, then fail on its first real question.
The rule this is built on
An agent may choose when. It must never choose what.
Invoice text arrives from your customers' systems, so it is treated as data that could be hostile rather than as instructions. Anything an injected instruction could reach is something where picking the moment is harmless. That is why an agent can start a sync, which was going to run anyway, and why raising a payment link is restricted and bounded.
Three ways in
Pick by who is doing the calling, and by how much you want to set up.
An Agent Skill, the simplest way to start
A skill is one page of instructions written for an assistant rather than for you. Give yours getfinero.com/skill.md and it learns what Finero is, what it is allowed to do, and how to connect. There is nothing to install and nothing to configure first. If your assistant keeps skills as files, save it as finero-receivables/SKILL.md.
The MCP server, when a person is present
The session acts as the person who approved it, so the assistant sees exactly the rows they see. Streamable HTTP, authorised with OAuth 2.1, and published to the official MCP registry as com.getfinero/finero, so a client that can resolve a name does not need a URL at all. Detail on the MCP server page.
The HTTP API, when nothing is attended
A key acts as the workspace rather than as a person, which is right for a sync job or a backend service and wrong for an assistant. See the API documentation and how credentials work.
Connecting takes three steps
- 01
An admin opens the workspace to agents
One switch, in Finero under Settings, then API and agents. It is off until someone turns it on, and while it is off nothing can connect, an administrator included. There are no credentials to create and nothing to hand out: this is the whole of the administrator's part.
- 02
Connect from your own assistant, and approve
Add Finero as a connector. Your assistant registers itself and sends you to a consent screen naming what it will be able to reach, and which workspace it is joining. Approving is what creates the connection. Consent is recorded per person, so it is one click, once, rather than a prompt every time.
- 03
Ask it something
"How much is outstanding?" "Which invoices are overdue?" "Did the sync run?" The assistant reads your workspace as you, so it sees exactly the rows you see. To point an agent at Finero without any configuration at all, hand it getfinero.com/skill.md.
What you need to provide
An agent cannot bootstrap itself into your workspace, deliberately. One person has to do one thing first, and it takes about a minute.
- An administrator, once. Only an admin can open the workspace to agents at all, and only an admin's own connection can write. A member's agent is refused by the database, not by the interface.
- Nothing to copy. Assistants register themselves, so there is no client ID or secret to mint, hand over or lose. What a person judges the request by is the address the browser will be sent back to, shown on the consent screen. The assistant's own name is shown too, labelled unverified, because it is a claim the assistant makes about itself.
- Consent, per person. Each person connecting approves once. Their session then carries their own access, which is what lets you revoke one person without disturbing anyone else.
If something goes wrong, look one step later than you expect. A workspace that has not been opened to agents does not stop the assistant connecting. It connects, lists what it can do, and then fails on the first real request. That is authorisation failing, not the connection, and the fix is almost always step one.
For the agent reading this
Everything a machine needs is published and generated, so none of it can drift from what the product does:
- /agents.md, the agent contract: capabilities, boundaries and every entry point
- /skill.md, the Agent Skill
- OpenAPI specification and the generated API reference
- /.well-known/api-catalog, an RFC 9727 index of every API surface
- /llms.txt, a summary of the product
The tool list is whatever the server answers at runtime, and the API surface is whatever the specification says. Nothing on this page restates either, because a second copy is the one that goes stale and gets believed.