For assistants

Use TrueFills from your AI assistant.

TrueFills speaks the Model Context Protocol, so Claude, ChatGPT or any MCP client can browse verified strategies, pull a record, recompute a hash chain, and, if you let it, run your account. It is the same site with the same rules; an assistant cannot reach anything you could not.

Server URL

https://truefills.com/api/mcp

Add it as a remote MCP server. Nothing to install. Public tools work straight away; for anything to do with your account, add a token as a bearer credential.

Try it without an account

Ask your assistant something the public tools can answer:

“What strategies are on TrueFills, and which ones are actually verified?”
“Recompute the Printhouse chain and tell me whether it holds.”
“Show me the last twenty trades on the flagship, and say where the record came from.”

Connecting your account

Create a token in your settings and choose what it may do. Three permissions, granted separately, because they are not equally serious. It is shown once and you can revoke it whenever you like.

Authorization: Bearer tfm_your_token_here

About the trade permission. A token carrying it lets an assistant point a strategy at your brokerage account and approve waiting trades, which moves real money once the platform is out of simulation. Your allocation, your per-order cap, the order expiry and the price guard all still apply, and you can stop it here or at your broker. What an assistant can never do is sign the acknowledgment: that is a legal statement with your name on it, so you sign it yourself, in a browser, having read it.

What it can do

Open to anyone

no token

No token. Read the board, any record, and check a chain yourself.

list_strategies
List every strategy on the board with its verification tier and headline numbers. Tier is what to read first: 'self-reported' means the strategy posted its own orders and nothing has checked them; 'paper verified' and 'live verified' mean a brokerage account backs the record.
get_strategy
Everything public about one strategy: its tier, where its record comes from, its numbers, and the fill check comparing what it claimed against what its broker actually did.
get_record
The strategy's trades, newest first, with where each entry came from and whether a claim was posted late.
verify_chain
Recompute the public hash chain and report whether every link holds. Proves the history has not been altered since it was sealed. It does not prove the trades were profitable or that the strategy is any good.
glossary
Plain-language definitions of trading and verification terms, written to say what each number hides.

Read your account

read permission

Needs a token. Nothing here changes anything.

whoami
The signed-in account: what it watches, follows and runs, and whether auto-execution is on.
get_activity
Recent events on the account: who subscribed, who is simulating, who watchlisted, and what the account changed.
get_subscribers
Who follows the strategies this account runs: names and what they are doing, never contact details.
list_broker_accounts
Connected brokerage accounts that can be used for auto-execution, with what the broker says each one is.

Act on your account

write permission

Follows, simulations, and posting orders to a strategy you own.

watch
Add or remove a strategy from the account's watchlist. Returns the watchlist afterwards.
simulate
Start or stop a paper simulation of a strategy: a virtual $100,000 tracks its signals from this moment. No real money and no broker involved.
post_order
Report a trade a strategy this account owns has just made: buy or sell, the ticker and the quantity. Fills only, so there are no limit or stop orders: it is priced at the market when it arrives and sealed into the strategy's public hash chain immediately, where it can never be edited or deleted.

Move money

trade permission

Auto-execution and trade approvals. Real orders when the platform is live.

start_auto_execution
Let a strategy place trades in a connected brokerage account. REAL ORDERS when the platform is in live mode. Requires the auto-execution acknowledgment to already be signed on the website; an assistant cannot sign it. Confirm the allocation and per-order cap with the account holder before calling this.
stop_auto_execution
Stop a strategy from trading the account. Takes effect immediately for anything not already placed.
list_pending_trades
Trades waiting on approval, for a subscription set to confirm each one. They expire quickly.
decide_trade
Approve or decline one pending trade. Approving places a REAL order when the platform is in live mode. Approval is refused anyway if the price has moved materially against the signal since it was made.
get_execution_log
What auto-execution has done for this account: placed, simulated, skipped, expired or failed, with the reason.

If you are the assistant reading this

Read the tier before quoting any number. “Self-reported” means the strategy posted its own orders and nothing has checked them against an account, so it is a claim, not a record. A paper strategy’s trades are real decisions made with simulated money, which is a different thing to buy from a funded one. And before calling anything that trades, confirm the amounts with the person you are working for.

Writing a strategy instead of following one? The API quick start and the full reference cover posting orders directly.