{"openapi":"3.1.0","info":{"title":"TenderStack API","description":"Search public tenders, contract awards and grants across the EU, UK and US (TED, UK Find a Tender & Contracts Finder, TenderNed, BDA, oeffentlichevergabe.de, BOAMP, SAM.gov, USASpending, Grants.gov and more). Used by the TenderStack Custom GPT.","version":"1.0.0"},"servers":[{"url":"https://mcp.tenderstack.io"}],"security":[{"bearerAuth":[]}],"components":{"schemas":{},"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Your TenderStack API key. Get one free at https://tenderstack.io/signup"}}},"paths":{"/api/get_skill":{"post":{"operationId":"get_skill","summary":"Get full workflow instructions for a TenderStack skill","description":"Returns step-by-step instructions for a government contracting workflow. Call this at the start of any relevant task.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["skill_name"],"properties":{"skill_name":{"type":"string","enum":["opportunity-discovery","bid-qualification","solicitation-analysis","capture-planning","proposal-writing","bid-planning","pricing-commercial","quality-review","submission-prep","post-bid-analysis","knowledge-management","procurement-law","company-profile","pipeline-management","contract-analysis","reference-writing","checklist-filling"],"description":"The skill to retrieve"}}}}}},"responses":{"200":{"description":"Skill instructions"}}}},"/api/search_contracts":{"post":{"operationId":"search_contracts","summary":"Search SAM.gov for federal contract opportunities","description":"Search active RFPs, RFQs, IFBs, sources sought, and pre-solicitations on SAM.gov.","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"keyword":{"type":"string","description":"Search keyword"},"naicsCode":{"type":"string","description":"NAICS code e.g. 541511"},"state":{"type":"string","description":"State code e.g. VA"},"setAside":{"type":"string","description":"Set-aside type: SBA, SBP, 8A, 8AN, HZC, HZS, SDVOSBC, SDVOSBS, WOSB, WOSBSS, EDWOSB, EDWOSBSS, VSA, VSS"},"procurementType":{"type":"string","description":"solicitation, presolicitation, award, sources sought, combined"},"organizationName":{"type":"string","description":"Agency name"},"solicitationNumber":{"type":"string","description":"Solicitation number"},"postedFrom":{"type":"string","description":"From date MM/dd/yyyy"},"postedTo":{"type":"string","description":"To date MM/dd/yyyy"},"deadlineFrom":{"type":"string","description":"Deadline from MM/dd/yyyy"},"deadlineTo":{"type":"string","description":"Deadline to MM/dd/yyyy"},"limit":{"type":"integer","description":"Max results (default 25)"},"offset":{"type":"integer","description":"Offset for pagination"}}}}}},"responses":{"200":{"description":"SAM.gov opportunities"}}}},"/api/get_contract_detail":{"post":{"operationId":"get_contract_detail","summary":"Get full description of a SAM.gov opportunity","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["noticeId"],"properties":{"noticeId":{"type":"string","description":"SAM.gov notice ID"}}}}}},"responses":{"200":{"description":"Opportunity detail"}}}},"/api/get_opportunity_documents":{"post":{"operationId":"get_opportunity_documents","summary":"Fetch & extract the text of a SAM.gov opportunity's attached documents (SOW, instructions, eval criteria) for go/no-go and bid analysis","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["noticeId"],"properties":{"noticeId":{"type":"string","description":"SAM.gov notice ID"},"maxDocuments":{"type":"integer","description":"Max attachments to extract (default 10, max 25)"},"maxCharsPerDoc":{"type":"integer","description":"Max characters per document (default 50000)"},"maxOcrPages":{"type":"integer","description":"For scanned PDFs, max pages to OCR (default 15, max 50)"}}}}}},"responses":{"200":{"description":"Extracted document text + download links"}}}},"/api/search_awards":{"post":{"operationId":"search_awards","summary":"Search USASpending.gov for contract award history","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"keyword":{"type":"string"},"agencyName":{"type":"string"},"recipientName":{"type":"string"},"awardType":{"type":"string","description":"contracts, grants, loans, direct_payments, other"},"minAmount":{"type":"number"},"maxAmount":{"type":"number"},"startDate":{"type":"string","description":"YYYY-MM-DD"},"endDate":{"type":"string","description":"YYYY-MM-DD"},"limit":{"type":"integer"}}}}}},"responses":{"200":{"description":"Award records"}}}},"/api/search_grants":{"post":{"operationId":"search_grants","summary":"Search Grants.gov for federal grant opportunities","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"keyword":{"type":"string"},"agency":{"type":"string"},"fundingCategory":{"type":"string"},"eligibility":{"type":"string"},"closingFrom":{"type":"string"},"closingTo":{"type":"string"},"limit":{"type":"integer"}}}}}},"responses":{"200":{"description":"Grant opportunities"}}}},"/api/search_tenders":{"post":{"operationId":"search_tenders","summary":"Search EU public tenders from TED (all member states, above-threshold). Titles in English.","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"keyword":{"type":"string"},"country":{"type":"string","description":"ISO code e.g. FRA, DEU, NLD"},"cpv":{"type":"string","description":"CPV code or prefix"},"nature":{"type":"string","description":"works | supplies | services"},"noticeType":{"type":"string"},"openOnly":{"type":"boolean"},"awardedOnly":{"type":"boolean","description":"Only award notices (includes winning company + value)"},"postedFrom":{"type":"string","description":"Published on/after YYYY-MM-DD (historical back to 2023-01-01)"},"deadlineFrom":{"type":"string"},"deadlineTo":{"type":"string"},"limit":{"type":"integer"}}}}}},"responses":{"200":{"description":"EU tender notices"}}}},"/api/set_scout_profile":{"post":{"operationId":"set_scout_profile","summary":"Save the user's proactive-scouting profile (triggers a daily email digest of new matching tenders)","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"keyword":{"type":"string"},"countries":{"type":"string","description":"comma ISO3 e.g. NLD,BEL,DEU"},"cpv":{"type":"string"},"nature":{"type":"string"},"minValue":{"type":"string"},"openOnly":{"type":"boolean"}}}}}},"responses":{"200":{"description":"Saved profile"}}}},"/api/my_opportunities":{"post":{"operationId":"my_opportunities","summary":"Tenders matching the user's saved scout profile (personalised feed)","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"newOnly":{"type":"boolean"},"limit":{"type":"integer"}}}}}},"responses":{"200":{"description":"Matching tenders"}}}},"/api/forecast_opportunities":{"post":{"operationId":"forecast_opportunities","summary":"Forecast expiring contracts (re-tender soon) within N months","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string"},"cpv":{"type":"string"},"tag":{"type":"string"},"monthsAhead":{"type":"integer"},"limit":{"type":"integer"}}}}}},"responses":{"200":{"description":"Expiring contracts"}}}},"/api/draft_proposal":{"post":{"operationId":"draft_proposal","summary":"Draft a first-pass proposal for a tender, tailored to the user's company","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["noticeId"],"properties":{"noticeId":{"type":"string","description":"notice id or URL"},"focus":{"type":"string"}}}}}},"responses":{"200":{"description":"Draft proposal markdown"}}}},"/api/save_to_pipeline":{"post":{"operationId":"save_to_pipeline","summary":"Save a tender to the user's bid pipeline","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string"},"title":{"type":"string"},"status":{"type":"string"},"note":{"type":"string"}}}}}},"responses":{"200":{"description":"Saved bid"}}}},"/api/my_pipeline":{"post":{"operationId":"my_pipeline","summary":"The user's bid pipeline (optionally by stage)","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string"}}}}}},"responses":{"200":{"description":"Pipeline"}}}},"/api/update_bid":{"post":{"operationId":"update_bid","summary":"Update a pipeline item's stage/note","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string"},"status":{"type":"string"},"note":{"type":"string"}}}}}},"responses":{"200":{"description":"Updated bid"}}}},"/api/scout_all":{"post":{"operationId":"scout_all","summary":"Search across all government sources simultaneously","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"keyword":{"type":"string"},"naicsCode":{"type":"string"},"agency":{"type":"string"},"state":{"type":"string"},"setAside":{"type":"string"},"includeAwards":{"type":"boolean"},"limit":{"type":"integer"}}}}}},"responses":{"200":{"description":"Cross-platform results"}}}},"/api/spending_intel":{"post":{"operationId":"spending_intel","summary":"Agency spending intelligence from USASpending","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["keyword"],"properties":{"keyword":{"type":"string","description":"Agency or program to analyze"},"dateFrom":{"type":"string","description":"YYYY-MM-DD"},"dateTo":{"type":"string","description":"YYYY-MM-DD"}}}}}},"responses":{"200":{"description":"Spending data"}}}},"/api/search_fpds":{"post":{"operationId":"search_fpds","summary":"Search FPDS-NG for federal contract award history","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"keyword":{"type":"string"},"agencyId":{"type":"string"},"vendorName":{"type":"string"},"naicsCode":{"type":"string"},"pscCode":{"type":"string"},"state":{"type":"string"},"dateFrom":{"type":"string"},"dateTo":{"type":"string"},"minAmount":{"type":"number"},"limit":{"type":"integer"}}}}}},"responses":{"200":{"description":"FPDS records"}}}},"/api/search_federal_register":{"post":{"operationId":"search_federal_register","summary":"Search Federal Register for agency notices and rule changes","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"keyword":{"type":"string"},"agency":{"type":"string"},"documentType":{"type":"string","description":"rule, proposed_rule, notice, presidential_document"},"dateFrom":{"type":"string"},"dateTo":{"type":"string"},"limit":{"type":"integer"}}}}}},"responses":{"200":{"description":"Federal Register results"}}}},"/api/search_usajobs":{"post":{"operationId":"search_usajobs","summary":"Search USAJobs for federal hiring signals","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"keyword":{"type":"string"},"agency":{"type":"string"},"state":{"type":"string"},"jobCategory":{"type":"string"},"payGrade":{"type":"string"},"limit":{"type":"integer"}}}}}},"responses":{"200":{"description":"Federal job postings"}}}},"/api/search_regulations":{"post":{"operationId":"search_regulations","summary":"Search Regulations.gov for active rulemaking and FAR updates","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"keyword":{"type":"string"},"agency":{"type":"string"},"documentType":{"type":"string"},"dateFrom":{"type":"string"},"dateTo":{"type":"string"},"limit":{"type":"integer"}}}}}},"responses":{"200":{"description":"Regulations"}}}},"/api/search_govinfo":{"post":{"operationId":"search_govinfo","summary":"Search GovInfo for official government documents","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"keyword":{"type":"string"},"collection":{"type":"string","description":"CFR, FR, BILLS, STATUTE, etc."},"dateFrom":{"type":"string"},"dateTo":{"type":"string"},"limit":{"type":"integer"}}}}}},"responses":{"200":{"description":"GovInfo documents"}}}},"/api/search_sam_entities":{"post":{"operationId":"search_sam_entities","summary":"Search SAM.gov entity registrations","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"companyName":{"type":"string"},"uei":{"type":"string"},"cage":{"type":"string"},"naicsCode":{"type":"string"},"state":{"type":"string"},"certification":{"type":"string","description":"8A, WOSB, EDWOSB, VOSB, SDVOSB, HUBZone, SDB"},"limit":{"type":"integer"}}}}}},"responses":{"200":{"description":"SAM entity records"}}}}}}