MishiSpark for AI agents on Square stores

Give an AI agent read-only access to a Square store's sales, products, orders and inventory, let it ask questions in plain language and prepare exports, and run checkout audits. Agents pay per call with credits. API keys come with every plan, including Free.

Not public yet. The MCP endpoint and the direct tool API are switched off while we finish them. This page describes what they offer when they open. The connect flows and the app work today.

12 analytics tools

The same tools MishiSpark's own chat uses, 1 credit per call; an export costs 5.

Chat

Ask a question; the AI analyst runs the tools and answers, for 10 credits a question.

Checkout audits

Can AI shopping agents find, understand and buy from this store? Seven dimensions, evidence on every finding. Square has no platform-specific reads yet; the audit uses the public pages and structured data. Methodology

Connect a Square store

Authorize MishiSpark with Square (OAuth), or paste an access token.
An agent can connect with add_square_connection and an access token.
The agent calls list_connections and uses the connection id in every call.

Connect Square API keys

Connect from the agent

add_square_connection (scope connections:write) takes:

access_token
location_id
refresh_token (optional)

The first sync starts in the background.

Data is location-scoped: one connection per Square location.
Reads only. MishiSpark never writes to Square.

Analytics tools

get_sales	Revenue, orders and average order value for a date range, by day, week or month.
compare_periods	Compare revenue, orders, average order value and units for two date ranges.
get_source_attribution	Revenue and orders by traffic source and channel.
get_discount_analysis	Discount codes with their usage, discount amount and revenue.
get_cohort_analysis	Customer cohorts by acquisition month: size, repeat rate, lifetime value.
search_products	Search the catalogue by name, SKU or barcode, with category and vendor filters.
get_product_detail	The full record of one product: prices, cost, margin, stock.
get_inventory_detail	Stock levels, inventory value and inventory health.
lookup_order	One order by number or id, read live from the platform.
get_product_sales	Sales per product for any date range.
prepare_export	A CSV or Excel export of store data, prepared for download.
analyze_orders	Orders, revenue and units from order lines, grouped by hour, day and more.

Every tool needs the scope analytics:read and a connection_id the key's owner owns; prepare_export also needs exports:read.

The MCP endpoint

One remote MCP server (streamable HTTP) at https://api.spark.mishipay.com/mcp/, authenticated with an API key (X-API-Key or Authorization: Bearer spk_live_…). Each tool checks the key's scopes. Besides one tool per analytics tool above, it offers:

Ask in plain language

Scope chat:write

The AI analyst answers a question with the full tool loop and returns every tool call it made.

ask

Connections

Scope connections:read / connections:write

List the stores a key may read; connect WooCommerce, Magento, Odoo, Square or Clover with API credentials.

list_connectionsadd_<platform>_connection

Checkout audits

Scope audit:read / audit:write

Start an audit, follow it, and read the report and its screenshots.

checkout_audit_requestcheckout_audit_listcheckout_audit_statuscheckout_audit_reportcheckout_audit_artefact

Domain ownership

Scope domains:write

Prove ownership of a store domain with a DNS TXT record or a meta tag to unlock owner audits.

claim_domainverify_domain

Credits and prices

Scope billing:read / billing:write

Read the balance and the price list; a top-up returns a payment session that a person completes.

credits_balancecredits_topuppricing

# Claude Code, once the endpoint is public
claude mcp add --transport http spark https://api.spark.mishipay.com/mcp/ \
  --header "X-API-Key: $SPARK_API_KEY"

Example prompts

"Which products will run out first at the current sell-through?"

"Compare this week's revenue by source with last week and export the table."

"Audit my store for AI-agent readiness and list the top three findings."

Pricing: Tool call 1 credit Checkout audit methodology Trust and security

Connect a Square store

Analytics tools

The MCP endpoint

Example prompts

Ready to double your store sales?