MCP · REST · Solana

Dip it before you buy it.

Litmus is a test strip for your trading agent. One call tests a Solana token in seconds and returns a 0–100 score, a call and the evidence: live authorities, launch-block snipers, the dev's bag, whale stacks, ticker clones and bot volume.

Free: 30 tests a day. Agents plug in with one URL: connect over MCP.

TEST STRIP · EXAMPLE · $GLOWWORMHOSTILE

Authorities: freeze live
Token-2022: no traps
Launch block: 9% still held
Dev wallet: sold 100%
Top 10: 31% of supply
Ticker: clone of $3.4M

12 / 100reads acid · pH 1.7

~5 sper test, cold

20+checks on every token

0–100score, with every reason

30free tests a day

How it works

Dip. Develop. Read.

Your agent asks once before it buys. Litmus reads the chain and the market live, then answers in plain JSON the agent can act on and you can audit.

01 · DIP
The agent asks

It calls the scan_token tool over MCP, or GET /v1/scan/{mint} over REST. One URL. No SDK, no wallet, no signup for the free tier.
```
scan_token({ mint: "7xKX…pump" })
```
02 · DEVELOP
Litmus reads the chain

The mint and its Token-2022 extensions, the launch block, the creator's wallet, the top holders and every pool, live from Solana and DexScreener.
```
› mint ........ authorities revoked
› launch ...... 6 wallets in block
› holders ..... top 10 = 61%
```
03 · READ
The agent decides

A score, a call and each flag with its penalty. Pass on HOSTILE, shrink the size on WATCH, carry on when it's CLEAR.
```
{ "score": 31,
  "verdict": "HOSTILE",
  "flags": [ … ] }
```

Checks

What turns the strip red

Each check is a rule with a fixed penalty. Nothing hidden, nothing learned from vibes: the report lists every rule that fired and why.

Supply printers

A live mint authority can print new tokens whenever it likes and dilute everyone holding.

mint_authority

Wallet locks

Freeze authority, accounts that start frozen, transfers that can be paused. Any of them can stop you selling.

freeze_authorityt22_pausable

Token-2022 traps

Permanent delegates that can pull tokens from your wallet, transfer hooks, hidden taxes, tokens that can't move at all.

t22_permanent_delegatet22_transfer_fee

Launch-block snipers

Every wallet that bought in the same slot the token was created, and how much of supply they still sit on.

bundle_holdingbundle_launch

The dev's bag

What the creator bought at launch, what's still in the wallet, and how much of it has already been dumped.

dev_holdingdev_sold

Whale stacks

The ten biggest wallets, with bonding curves, pools, vaults and burns stripped out, so the share counts people.

top10

Ticker clones

Another token trading under the same ticker at ten times the market cap or more. The usual sign you found the fake.

copycat

Dead or fake markets

No pool, no trades for a day, liquidity too thin to exit, or turnover so high it's bots trading with themselves.

wash_volumethin_liquidity

Readings

Three readings. One rule each.

The score starts at 100 and every flag takes its penalty off. Where it lands decides the reading.

HOSTILE 0–44

Do not buy. At least one serious red flag, or several smaller ones stacking up.

WATCH 45–74

Size down, wait, or ask a human. Risk signals are present but nothing is decisive.

CLEAR 75–100

No major flags. Trade at normal size.

Some flags also cap the score outright. A live mint or freeze authority can never score above 40, and a token that can't be transferred never scores above 10.

Fresh samples

On the bench right now

The most-boosted Solana tokens on DexScreener, ranked by the last hour of volume. Test any of them.

Connecting

Token	Market cap	Liquidity	Vol 1h	1h	Age	Test

Connect

One line, and your agent can test.

Litmus speaks MCP, so any agent that takes a remote MCP server can use it straight away. Everything else can call the REST endpoint.

Two tools: scan_token and trending_tokens
The same JSON report over MCP and REST
Free tier needs no key: 30 tests a day per IP

Read the docs

Run this once in your terminal:

claude mcp add --transport http litmus /mcp

Add this to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "litmus": { "url": "/mcp" }
  }
}

Settings → Connectors → Add custom connector, then paste this URL:

/mcp

Any language, any agent framework:

curl /v1/scan/MINT_ADDRESS

Agents trade in milliseconds.
Hand yours a test strip.

One test before every buy costs a few seconds. A rug costs the whole position.

Connect your agent Test a token