Teachers Pay Teachers MCP Server

npx add-mcp 'https://cotlet.dev/mcp/v1/teachers-pay-teachers'

Cotlet · Integrations · How it works · Security · For developers · For automation agencies · Blog · API docs · Help center · Changelog · Contact · Pricing · Sign up

Teachers Pay Teachers API and MCP server: Let your AI agent look after your TPT store.

Teachers Pay Teachers has no public API, no webhooks and no MCP server for sellers (checked 24 Oct 2026). Its help center returns no article for "api". Cotlet runs 14 TPT tools hosted, over MCP for agents and REST for scripts.

Read your TPT products, sales and buyer questions through MCP or REST. Connect an agent or build a seller reporting workflow with HTTP requests.

MCP setup REST API guide

• Free 7-day trial, no card
• Unofficial, not affiliated with Teachers Pay Teachers
• Page: https://cotlet.dev/integrations/teachers-pay-teachers-api-mcp-server

What can you automate in Teachers Pay Teachers?

• Answer buyer questions from the listing
• Throw a sale on one custom category
• Announce it in a Note to Followers
• Report earnings and top 5 resources
• Replace a file and notify buyers
• Raise prices on a set of bundles

Does Teachers Pay Teachers have an MCP server or an API?

• The official way to hand off store work is Virtual Assistant Login: a person you invite can edit listings, upload files and reply to buyer questions, but cannot see earnings on the Traffic tab.
• Zapier, n8n, Pipedream and Composio have no TPT app. Product Statistics and Sales Reports export a CSV, by hand.
• One community MCP server on GitHub uploads new listings through a local Chrome window. It does not read sales or answer buyers.

What you need	Virtual Assistant	GitHub MCP server	Cotlet
Answer buyer questions	Yes, a person	No	Yes, after your OK
Read earnings and sales lines	No earnings	No	Yes
Throw a sale, send a Note to Followers	Not in the VA rights TPT lists	No	Yes, after your OK
Upload a new listing	Yes	Yes, from local files	Yes, inactive first
Runs with your computer off	When they work	No	Yes, hosted
Kept working when TPT changes a page	Yes, a person	You fix it	Yes, tested every 12 h

Checked 24 Oct 2026. Sources: TPT Help: How do I add a product to my TPT store?, TPT Help: Product Insights Report vs Seller Dashboard, TPT Help: How do I respond to Buyer questions?, TPT Help: What can a Virtual Assistant do in my store?, TPT Help: Where can I find statistics on my products?

How does Cotlet connect to Teachers Pay Teachers?

1. Sign in to Teachers Pay Teachers. Use your own account in its Cotlet Cloud Browser.
2. Choose MCP or REST. Connect your agent or create a Cotlet API key.
3. Run your workflow. Ask your agent or send an HTTP request.

We never keep your TPT password, and no answer, sale, note or price change goes out until you approve it.

Connect Teachers Pay Teachers to your agent or workflow

Use MCP with your AI agent, or HTTP requests in n8n, Make, Zapier and scripts. Follow the MCP setup below or jump to the REST guide.

1. Turn on TPT for agents. Make a Cotlet account, log in to your TPT seller account in its Cloud Browser and press Enable for agents.
2. Add the Cotlet address. Add https://cotlet.dev/mcp/v1 to your agent as a remote MCP server or custom connector.
3. Allow the connection. Chat apps open a Cotlet sign-in page. Editors, n8n and scripts use an API key from the console.

TPT shares one address, https://cotlet.dev/mcp/v1, with every other app you turn on. Enabled TPT after connecting? Refresh the connector and the 14 tools show up.

Claude:

Settings > Connectors > Add custom connector
URL: https://cotlet.dev/mcp/v1/connect

Claude Code:
claude mcp add --transport http cotlet-tpt \
  https://cotlet.dev/mcp/v1 \
  --header "Authorization: Bearer $COTLET_API_KEY"

ChatGPT:

Settings > Apps & Connectors > Create
MCP server URL: https://cotlet.dev/mcp/v1/connect
Authentication: OAuth

Cursor:

// ~/.cursor/mcp.json
{
  "mcpServers": {
    "cotlet-tpt": {
      "url": "https://cotlet.dev/mcp/v1",
      "headers": { "Authorization": "Bearer ${env:COTLET_API_KEY}" }
    }
  }
}

Codex:

# ~/.codex/config.toml
[mcp_servers.cotlet-tpt]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY"

n8n:

MCP Client Tool (inside an AI Agent)
Transport: HTTP Streamable
URL: https://cotlet.dev/mcp/v1
Auth: Bearer, <your key>
Tool: teachers_pay_teachers_read

Make, Zapier:

Make: MCP Client > Call a tool
Zapier: MCP Client by Zapier > Run Tool
Server URL: https://cotlet.dev/mcp/v1
Token: <your key>
Tool: teachers_pay_teachers_write

How to use the Teachers Pay Teachers REST API

Create your Cotlet API key

Sign in to Teachers Pay Teachers in its Cotlet Cloud Browser and enable the app for agents. Use your TPT Seller login.

Create a Cotlet API key with access to Teachers Pay Teachers and its read operations. Store it as COTLET_API_KEY in your environment or automation platform's credential store.

Make your first Teachers Pay Teachers API request

cURL: list_products:

curl "https://cotlet.dev/api/v1/teachers-pay-teachers/products?limit=5" \
  -H "Authorization: Bearer $COTLET_API_KEY"

Read products and follow the cursor

A successful REST call puts the tool output in result. This illustrative response excerpt omits call IDs, messages and credit details.

Illustrative response excerpt:

{
  "status": "success",
  "app": "teachers-pay-teachers",
  "tool": "list_products",
  "result": {
    "products": [
      {
        "product_id": "11204567",
        "title": "Fraction Task Cards, Grades 3-4",
        "type": "digital_download",
        "price_cents": 600,
        "status": "active",
        "custom_category": "Fractions"
      }
    ],
    "next_cursor": null
  }
}

Read result.products and pass result.next_cursor unchanged as cursor until null. Pages default to 50 records, with a maximum of 100.

Keep status, type, custom category and limit fixed while paging. Product prices and earnings use cents, so preserve units when creating reports.

Sales reads return one item sold per row and accept a cursor without a page-size input. Do not collapse separate sales by product ID; Search Analytics dates start at 2025-01-01.

Teachers Pay Teachers workflows for agents and automations

Tool	Connect through	Example workflow
n8n	HTTP Request	Read products and product details into a catalog audit, retaining prices in cents and custom categories.
Make	HTTP > Make a request	Combine products and dated product stats into a performance report with views, earnings and conversion.
Python or Node.js	REST API	Read store stats and search keywords into a period report, using supported Search Analytics dates.

Send Authorization: Bearer <your Cotlet API key> in request headers. You configure the schedule, destination and record comparisons.

Cotlet reads Teachers Pay Teachers; your workflow steps write to your chosen destination. These HTTP workflows do not require a native Cotlet connector or a prebuilt template.

Python and Node.js can use the same HTTP requests without an AI agent. Keep access keys in credentials, outside shared workflow exports.

The API and MCP reference lists operations and inputs. The REST API guide explains authentication, errors and approvals.

Teachers Pay Teachers API endpoints and MCP tools

Product listings

New listings are Digital Downloads from a PDF or ZIP and start inactive. Past buyers keep their downloads when a listing goes inactive.

• List products (list_products, read): Your product listings with title, type, price, status and custom category.
• Get product (get_product, read): Full listing: title, description, price, additional license price, grades, subjects, tags, formats and files.
• Create product (create_product, write, asks first): New Digital Download listing from a file. Inactive by default; an active listing is live for buyers right away.
• Update product (update_product, write, asks first): Change title, description, price, additional license price, grades, subjects or tags of a listing.
• Set product status (set_product_status, write, asks first): Make a listing active or inactive. Past buyers keep their downloads.
• Upload revised file (upload_revised_file, write, asks first): Replace the product file and optionally notify past buyers with a note on what changed.

Earnings, sales and search

Seller Dashboard totals, Sales Details line by line, amounts in US cents. Search keywords start on 1 Jan 2025 and need an Exclusive Seller account.

• Get store stats (get_store_stats, read): Seller Dashboard totals: earnings, units sold, carts, unique buyers, views and conversions.
• Get product stats (get_product_stats, read): Per product: earnings, units sold, views, conversion, Wish Listed and Saved for Later.
• List sales (list_sales, read): Sales Details from your Sales Reports, one line per item sold, with earnings and sales tax.
• Get search keywords (get_search_keywords, read): Search Analytics: TPT search keywords that led buyers to your products, with visits, conversions and earnings.

Buyer questions

Answers are public on the product page and show your store name, never the agent.

• List buyer questions (list_buyer_questions, read): Questions from the Q&A section of your store, newest first, with product and any answer.
• Answer buyer question (answer_buyer_question, write, asks first): Post a public answer to a question on your product page.

Sales and Notes to Followers

TPT sales come in 5, 10, 15 or 20% off. TPT calls the Note to Followers a weekly message.

• Schedule sale (schedule_sale, write, asks first): Throw a sale on chosen products or your whole store for set dates.
• Send Note to Followers (send_note_to_followers, write, asks first): Weekly Note to Followers about new products or promotions, sent now or on a set date.

Inputs, REST path and example response of every tool: https://cotlet.dev/integrations/teachers-pay-teachers-api-mcp-server#tools

Who can see my TPT session, and how do I revoke it?

• What we store. Your logged-in TPT browser profile, AES-256-GCM encrypted, in Finland. No password.
• What your agent gets. The 14 TPT tools. Never the cookie or the login.
• What the session sees. Your seller pages: listings, earnings, sales lines, buyer questions.
• What no tool touches. Payouts, refunds, your membership, tax settings, password, closing the store.
• If TPT logs you out. You get an email with a link to log in again. We never type your password.
• How to cut access. Disable TPT for agents, reset the browser or delete the key. The next call fails.

cotlet.dev rates A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory (live results). We have no SOC 2 report or third-party pentest yet.

Is it against Teachers Pay Teachers' terms? Account safety

Don't use any automated means such as bots, spiders, or crawlers to download or otherwise obtain data from our services.

TPT Guidelines for All TPT'ers, 6 Oct 2026

The Terms of Service (updated 8 Dec 2025) make these guidelines part of the contract, and TPT may close any account "for any reason, with or without notice". The rule binds every tool that works in a logged-in TPT store, the GitHub server included. We found no public case of a TPT seller closed for automation (checked 24 Oct 2026).

How we keep your store looking like you:

• Your own seller account, logged in by you
• One Cloud Browser with a steady IP and cookies
• Answers, sales, notes, prices and files wait for your OK
• Sign-in and 2FA stay with you; we never bypass MFA
• If TPT objects, we pause the TPT tools for everyone within 24 h

Read stats once a week, not every hour: the clause is about pulling data in bulk. A Virtual Assistant you invite is the route TPT itself offers for help in your store.

What happens when Teachers Pay Teachers changes?

• 12 h between tests of the TPT reads
• 24 h between tests of writes buyers or followers would see
• $0 for a call to a TPT tool paused for repair

TPT changed its seller memberships on 1 Oct 2026 and moves seller pages often. When the Throw A Sale form or a Sales Reports column changes, the tool keeps its name and inputs. status.cotlet.dev checks the site, console and API every 3 minutes.

Approvals, undo and mistakes

1. Picks the resources. Active listings in the custom category you name. Freebies and inactive ones stay out.
2. Fits the discount. Asked for 25%? It offers 20%, the most a TPT seller sale allows.
3. Waits for your OK. Dates, discount and product count show in your Cotlet console.
4. Drafts the note. A Note to Followers for day one, sent after a second OK.

Action	Undo
Answer a buyer question	Edit or Delete it on the Q&A page
Change a price	Set it back; buyers in between paid the new price
Make a listing active	Yes, set_product_status; buyers keep their copy
Replace a file, buyers notified	Upload the old file again; the notice stays
Send a Note to Followers	No, it is out

All 7 write tools ask first, because each one reaches buyers, followers or your prices. The 7 reads run at once. Turn the wait off per tool for a scheduled run, or enable TPT read only.

Refunds are not a Cotlet tool. You refund a buyer on TPT yourself.

MCP call:

{
  "name": "schedule_sale",
  "arguments": {
    "discount": "20",
    "start_date": "2026-10-16",
    "end_date": "2026-10-18",
    "product_ids": [
      "11204567",
      "11204582",
      "9873310"
    ]
  }
}

REST:

curl -X POST https://cotlet.dev/api/v1/teachers-pay-teachers/sale/schedule \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"discount":"20","start_date":"2026-10-16","end_date":"2026-10-18","product_ids":["11204567","11204582","9873310"]}'

Tool output:

{
  "sale_id": "sale_48213",
  "status": "scheduled",
  "discount": 20,
  "start_date": "2026-10-16",
  "end_date": "2026-10-18",
  "products": 3
}

A cron job or spreadsheet script reaches the same tools over REST at /api/v1/teachers-pay-teachers: same key, same price as MCP. A call that fails costs nothing. The tools table lists the REST path of each tool.

How much does the Teachers Pay Teachers MCP server cost?

About $13 a month for a store of about 80 resources with 3 buyer questions a week, 2,250 credits. TPT keeps its own fees and payout split.

Job	Calls	Credits
Draft and post buyer answers, weekly	7 × 4	280
Earnings and top 5 report, weekly	8 × 4	320
Weekend sale with a Note to Followers	3 × 2	60
Revised file, buyers notified	2 × 2	40
New listing, uploaded inactive then live	2 × 2	40
Search keywords check, monthly	1 × 1	10
Cloud Browser, 30 days		1,500
Total		2,250

• Free 7-day trial, no card
• 10 credits per successful call, MCP or REST
• 50 credits a day for the Cloud Browser
• Works on Basic and Exclusive seller accounts

TPT publishes no store sizes, so the month is our example: seller surveys put a year-3 store at 60 to 100 products. Since 1 Oct 2026 TPT is $29 once (55% payout) or $59.95 a year (77.5%, 80% until 1 Jan 2027). Dollars at the $29 pack rate.

Teachers Pay Teachers MCP server on GitHub, a scraper or hosted: which to use

Option	What it does	Where it stops
grahamwaters/tpt-mcp	Local MCP server, 12 tools: fills the TPT upload form from a folder of listing files in its own Chrome window.	Uploads only, 0 stars, no license, last commit 9 Sep 2026. Your computer has to be on.
Apify actors, such as solidcode/teacherspayteachers-scraper	Public titles, prices, ratings and seller pages, about $7.50 per 1,000 results, into Zapier, Make or n8n.	No login: no earnings, questions, sales or listing edits.
Parse.bot TPT API	Unofficial REST with 7 reads on public listings, seller profiles and reviews.	Public data only; nothing in your store.
CSV exports from Product Statistics and Sales Reports	Your own numbers in a spreadsheet, free.	Downloaded by hand each time; no writes.

Watching competitors' prices? A scraper costs less. Uploading a batch of finished resources from your laptop? tpt-mcp does that. For the weekly store work behind your login, questions, sales, notes and earnings, there is no API to wrap, and that is where Cotlet works.

Also listed on: Odel, mcpbeat

Who runs Cotlet

Cotlet belongs to Take Group sp. z o.o., a software company registered in Poland, EU (VAT PL6342984273) and in business since 2019. Its founders are Bart Krawczyk (Co-founder, CTO) and Jake Slugocki (Co-founder, SEO, sales and marketing). Write to contact@cotlet.dev with questions about the TPT tools.

Teachers Pay Teachers API and MCP: questions

Can I use the Teachers Pay Teachers API without an AI agent?

Yes. Call Cotlet's REST API from a script or an HTTP step in n8n, Make or Zapier with your Cotlet key. MCP is the alternative for AI agents; you do not need to connect an agent to use REST.

How do I get access?

Sign up free at https://cotlet.dev, open Teachers Pay Teachers under Integrations in the console and log in to TPT in its Cloud Browser. The trial starts when you sign up, no card asked.

Does Teachers Pay Teachers have webhooks?

No. TPT sends no events out, so nothing tells an agent about a new question or sale. Run your agent on a schedule, for example every weekday at 4 pm, and let it read the Q&A list and Sales Details.

Does it work on a Basic Seller account?

Yes. Every tool works on Basic and Exclusive accounts except get_search_keywords: Search Analytics is an Exclusive Seller feature on TPT.

Can my Virtual Assistant and the agent work in the same store?

Yes. Right before posting, the agent lists the questions again and skips any that you or a Virtual Assistant answered in the meantime.

Is the MCP server different from the REST API?

Only the way in. Both have the same 14 tools, inputs and answers, one API key and one price. Agents use MCP; scripts and HTTP steps use REST.

Is Cotlet affiliated with Teachers Pay Teachers?

No. Cotlet is independent and not affiliated with Teachers Pay Teachers or IXL Learning.

---

Give your AI agents your signed-in browser.

Product: Integrations · How it works · Pricing · Security

Resources: Blog · API docs · Help center · Changelog · GitHub

Solutions: For developers · For automation agencies

Company: About · AI info: company facts · Contact

Legal: Terms of service · Privacy policy · Refund policy · Acceptable use · Cookie policy · DPA · Subprocessors

Elsewhere: Status page · Cotlet on GitHub · Cotlet on X · Cotlet on LinkedIn · Cotlet on Product Hunt · Cotlet on Crunchbase · Cotlet on SaaSHub

Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. About us

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.