The Synapse MCP connector routes your AI agent's tool calls to Synapse's own MCP server through Scalekit. Each user signs in to Synapse once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 48 tools.
- Tools
- 48
- What they doRead · write · destructive
- 48 · 0 · 048 read0 write0 destructive
- Users sign in with
- OAuth
- OAuth app
- Scalekit's or your own
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Synapse MCP connection
In AgentKit > Connections, create a Synapse MCP connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Scalekit credentials are available for Synapse MCP server, so you don't need to register an OAuth app.
Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'synapsemcp'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Synapse MCP:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'synapsemcp_get_evaluation',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "synapsemcp"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Synapse MCP:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="synapsemcp_get_evaluation",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user signs in once. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolsynapsemcp_check_synapse_idUse this when the user has a string that looks like a Synapse ID (e.g.Read-onlyValidate Synapse ID
Use this when the user has a string that looks like a Synapse ID (e.g. syn123456) and wants to check whether it exists in Synapse — verifies validity by querying the Synapse backend.
Inputs
syn_idstringrequired- The Synapse ID to validate (for example syn123456).
synapsemcp_check_user_certifiedUse this when the user wants to know whether a Synapse user has passed the certification quiz required for uploading human data.Read-onlyCheck User Certified
Use this when the user wants to know whether a Synapse user has passed the certification quiz required for uploading human data. User ID example: '1234567'.
Inputs
user_idintegerrequired- The numeric Synapse user ID.
synapsemcp_get_curation_taskUse this when the user wants the details of a single Synapse curation task by its numeric task ID.Read-onlyGet Curation Task
Use this when the user wants the details of a single Synapse curation task by its numeric task ID. Task ID example: 42.
Inputs
task_idintegerrequired- The numeric Synapse curation task ID.
synapsemcp_get_curation_task_resourcesUse this when the user wants the Synapse resources (RecordSets, Folders, EntityViews) linked to a curation task — the data the curator will act on.Read-onlyGet Curation Task Resources
Use this when the user wants the Synapse resources (RecordSets, Folders, EntityViews) linked to a curation task — the data the curator will act on. Task ID example: 42.
Inputs
task_idintegerrequired- The numeric Synapse curation task ID.
synapsemcp_get_entityReturn Synapse entity metadata by ID (projects, folders, files, tables, etc.).Read-onlyFetch Entity
Return Synapse entity metadata by ID (projects, folders, files, tables, etc.). Only retrieves metadata information - does not download file content.
Inputs
entity_idstringrequired- The Synapse entity ID to fetch (for example syn123456).
synapsemcp_get_entity_aclUse this when the user wants the sharing settings or access control list (ACL) of one single Synapse entity — who can access it and with what permissions.Read-onlyGet Entity ACL
Use this when the user wants the sharing settings or access control list (ACL) of one single Synapse entity — who can access it and with what permissions. Entity ID example: syn123456. Optionally filter to a single principal ID (user or team), e.g. '3379097'. Use list_entity_acl to audit ACLs across many entities under a container.
Inputs
entity_idstringrequired- The Synapse entity ID (for example syn123456).
principal_idinteger- Optional user or team ID to filter to a single principal.
synapsemcp_get_entity_annotationsReturn custom annotation key/value pairs for a Synapse entity.Read-onlyFetch Entity Annotations
Return custom annotation key/value pairs for a Synapse entity.
Inputs
entity_idstringrequired- The Synapse entity ID whose annotations to fetch (for example syn123456).
synapsemcp_get_entity_childrenList children for Synapse container entities (projects or folders).Read-onlyList Entity Children
List children for Synapse container entities (projects or folders).
Inputs
entity_idstringrequired- The Synapse container entity ID (project or folder) whose children to list (for example syn123456).
synapsemcp_get_entity_permissionsUse this when the user wants to know what the currently authenticated user is allowed to do on a Synapse entity (READ, UPDATE, DELETE, etc.).Read-onlyGet Entity Permissions
Use this when the user wants to know what the currently authenticated user is allowed to do on a Synapse entity (READ, UPDATE, DELETE, etc.). Entity ID example: syn123456. Returns the caller's own permissions only — use get_entity_acl to see everyone's permissions.
Inputs
entity_idstringrequired- The Synapse entity ID (for example syn123456).
synapsemcp_get_entity_provenanceReturn provenance (activity) metadata for a Synapse entity, including inputs and code executed.Read-onlyFetch Entity Provenance
Return provenance (activity) metadata for a Synapse entity, including inputs and code executed.
Inputs
entity_idstringrequired- The Synapse entity ID whose provenance to fetch (for example syn123456).
versioninteger- Optional entity version number to scope the provenance to a specific version. Omit for the latest version.
synapsemcp_get_entity_schemaUse this when the user wants to know which JSON schema (data model / validation contract) is bound to a Synapse entity.Read-onlyGet Entity Schema
Use this when the user wants to know which JSON schema (data model / validation contract) is bound to a Synapse entity. Entity ID example: syn123456. Returns the schema binding metadata, not the schema body — use get_json_schema_body for that.
Inputs
entity_idstringrequired- The Synapse entity ID (for example syn123456).
synapsemcp_get_entity_schema_derived_keysUse this when the user wants the annotation keys a bound JSON schema requires on a Synapse entity.Read-onlyGet Entity Schema Derived Keys
Use this when the user wants the annotation keys a bound JSON schema requires on a Synapse entity. Useful for knowing what metadata fields a schema is enforcing. Entity ID example: syn123456.
Inputs
entity_idstringrequired- The Synapse entity ID (for example syn123456).
synapsemcp_get_entity_schema_invalid_validationsUse this when the user wants the list of Synapse entities inside a Folder or Project that currently fail their bound JSON schema — the 'what's broken' view.Read-onlyGet Entity Schema Invalid Validations
Use this when the user wants the list of Synapse entities inside a Folder or Project that currently fail their bound JSON schema — the 'what's broken' view. Container entity ID example: syn123456.
Inputs
entity_idstringrequired- The Synapse entity ID (for example syn123456).
synapsemcp_get_entity_schema_validation_statisticsUse this when the user wants an aggregate validation summary for a Synapse entity container (Folder or Project) with a bound JSON schema — how many child entities pass or fail validation.Read-onlyGet Entity Schema Validation Statistics
Use this when the user wants an aggregate validation summary for a Synapse entity container (Folder or Project) with a bound JSON schema — how many child entities pass or fail validation. Entity ID example: syn123456.
Inputs
entity_idstringrequired- The Synapse entity ID (for example syn123456).
synapsemcp_get_evaluationUse this when the user wants a Synapse Evaluation queue — the challenge/competition queue that participants submit models or results to.Read-onlyGet Evaluation
Use this when the user wants a Synapse Evaluation queue — the challenge/competition queue that participants submit models or results to. Synonymous with 'challenge queue', 'leaderboard queue'. Evaluation ID example: '9600001'. Evaluation name example: 'DREAM Patient Data'.
Inputs
evaluation_idstring- The Synapse Evaluation (challenge queue) ID.
evaluation_namestring- The exact name of the Synapse Evaluation queue.
synapsemcp_get_evaluation_aclUse this when the user wants the resource-level access control list of a Synapse Evaluation queue (challenge queue) — which principals (users and teams) hold which access types on the queue.Read-onlyGet Evaluation ACL
Use this when the user wants the resource-level access control list of a Synapse Evaluation queue (challenge queue) — which principals (users and teams) hold which access types on the queue. Use for queue-administration questions like "who can score submissions". Distinct from get_evaluation_permissions, which reports the caller's own effective permissions. Evaluation ID example: '9600001'.
Inputs
evaluation_idstringrequired- The Synapse Evaluation (challenge queue) ID.
synapsemcp_get_evaluation_permissionsUse this when the user wants to know what the authenticated caller is allowed to do on a Synapse Evaluation queue (challenge queue) — submit, administer, etc.Read-onlyGet Evaluation Permissions
Use this when the user wants to know what the authenticated caller is allowed to do on a Synapse Evaluation queue (challenge queue) — submit, administer, etc. Returns the caller's own effective permission flags. Distinct from get_evaluation_acl, which lists the queue's full ACL across every principal. Evaluation ID example: '9600001'.
Inputs
evaluation_idstringrequired- The Synapse Evaluation (challenge queue) ID.
synapsemcp_get_json_schemaUse this when the user wants metadata about a specific Synapse JSON Schema (data model, validation contract).Read-onlyGet JSON Schema
Use this when the user wants metadata about a specific Synapse JSON Schema (data model, validation contract). Organization name example: 'org.sagebionetworks'. Schema name example: 'myDataset-1.0.0'.
Inputs
organization_namestringrequired- The Synapse JSON Schema organization name.
schema_namestringrequired- The Synapse JSON Schema name.
synapsemcp_get_json_schema_bodyUse this when the user wants the raw JSON document of a Synapse JSON Schema — the actual data model / validation rules.Read-onlyGet JSON Schema Body
Use this when the user wants the raw JSON document of a Synapse JSON Schema — the actual data model / validation rules. Organization name example: 'org.sagebionetworks'. Schema name example: 'myDataset-1.0.0'.
Inputs
organization_namestringrequired- The Synapse JSON Schema organization name.
schema_namestringrequired- The Synapse JSON Schema name.
versionstring- Optional version number. Omit for the latest.
synapsemcp_get_linkUse this when the user has a Synapse Link entity (a shortcut that points at another entity) and wants either the Link's own metadata or the target it resolves to.Read-onlyGet Link
Use this when the user has a Synapse Link entity (a shortcut that points at another entity) and wants either the Link's own metadata or the target it resolves to. Link entity ID example: syn123456. Set follow_link=False to inspect the Link itself instead of its target.
Inputs
entity_idstringrequired- The Synapse entity ID (for example syn123456).
follow_linkboolean- Whether to resolve the Link to its target entity (true) or return the Link's own metadata (false).default
true
synapsemcp_get_schema_organizationUse this when the user wants a Synapse JSON Schema Organization (namespace that owns a set of JSON schemas / data models) by name or numeric ID.Read-onlyGet Schema Organization
Use this when the user wants a Synapse JSON Schema Organization (namespace that owns a set of JSON schemas / data models) by name or numeric ID. Organization name example: 'org.sagebionetworks'. Organization ID example: 42.
Inputs
organization_namestringrequired- The Synapse JSON Schema organization name.
synapsemcp_get_schema_organization_aclUse this when the user wants the ACL of a Synapse JSON Schema Organization — who may publish schemas under that namespace.Read-onlyGet Schema Organization ACL
Use this when the user wants the ACL of a Synapse JSON Schema Organization — who may publish schemas under that namespace. Organization name example: 'org.sagebionetworks'.
Inputs
organization_namestringrequired- The Synapse JSON Schema organization name.
synapsemcp_get_submissionUse this when the user wants a specific Synapse submission — a challenge entry a participant sent to an Evaluation queue.Read-onlyGet Submission
Use this when the user wants a specific Synapse submission — a challenge entry a participant sent to an Evaluation queue. Submission ID example: '9722233'.
Inputs
submission_idstringrequired- The Synapse submission ID.
synapsemcp_get_submission_countUse this when the user wants only the count of Synapse submissions (challenge entries) in an Evaluation queue, not the submissions themselves.Read-onlyGet Submission Count
Use this when the user wants only the count of Synapse submissions (challenge entries) in an Evaluation queue, not the submissions themselves. Evaluation ID example: '9600001'.
Inputs
evaluation_idstringrequired- The Synapse Evaluation (challenge queue) ID.
synapsemcp_get_submission_statusUse this when the user wants the scoring status of a single Synapse submission (challenge entry) — e.g.Read-onlyGet Submission Status
Use this when the user wants the scoring status of a single Synapse submission (challenge entry) — e.g. RECEIVED, EVALUATION_IN_PROGRESS, SCORED. Submission ID example: '9722233'.
Inputs
submission_idstringrequired- The Synapse submission ID.
synapsemcp_get_teamUse this when the user wants a Synapse team by its numeric ID or name.Read-onlyGet Team
Use this when the user wants a Synapse team by its numeric ID or name. A Synapse team is a group of users (collaborators, members) that can be granted access to entities collectively. Team ID example: '3379097'. Team name example: 'NF-OSI Curators'.
Inputs
team_idinteger- The numeric Synapse team ID.
team_namestring- The exact name of the Synapse team.
synapsemcp_get_team_membersUse this when the user wants the roster of a Synapse team — who is on it.Read-onlyGet Team Members
Use this when the user wants the roster of a Synapse team — who is on it. Pages through the team membership API; pass an increased ``offset`` to fetch the next batch. Team ID example: '3379097'.
Inputs
team_idintegerrequired- The numeric Synapse team ID.
limitinteger- Maximum number of results to return.default
50 offsetinteger- Number of results to skip, for pagination.default
0
synapsemcp_get_team_membership_statusUse this when the user wants to know whether a specific Synapse user is already a member of, has applied to, or has been invited to a Synapse team.Read-onlyGet Team Membership Status
Use this when the user wants to know whether a specific Synapse user is already a member of, has applied to, or has been invited to a Synapse team. Team ID example: '3379097'. User ID example: '1234567'.
Inputs
team_idintegerrequired- The numeric Synapse team ID.
user_idintegerrequired- The numeric Synapse user ID.
synapsemcp_get_team_open_invitationsUse this when the user wants the pending (not yet accepted or rejected) invitations for a Synapse team.Read-onlyGet Team Open Invitations
Use this when the user wants the pending (not yet accepted or rejected) invitations for a Synapse team. Pages through the open-invitation API; pass an increased ``offset`` to fetch the next batch. Team ID example: '3379097'.
Inputs
team_idintegerrequired- The numeric Synapse team ID.
limitinteger- Maximum number of results to return.default
50 offsetinteger- Number of results to skip, for pagination.default
0
synapsemcp_get_user_profileUse this when the user wants a Synapse user profile by numeric user ID or username, or the authenticated caller's own profile when called with no arguments.Read-onlyGet User Profile
Use this when the user wants a Synapse user profile by numeric user ID or username, or the authenticated caller's own profile when called with no arguments. User ID example: '1234567'. Username example: 'janedoe'.
Inputs
user_idinteger- The numeric Synapse user ID.
usernamestring- The Synapse username.
synapsemcp_get_wiki_headersUse this when the user wants the table of contents of a Synapse wiki — the list of pages and sub-pages attached to an entity.Read-onlyGet Wiki Headers
Use this when the user wants the table of contents of a Synapse wiki — the list of pages and sub-pages attached to an entity. Owner entity ID example: syn123456. If the result hits the limit, call again with a higher offset to paginate.
Inputs
owner_idstringrequired- The Synapse entity ID that owns the wiki (for example syn123456).
limitinteger- Maximum number of results to return.default
50 offsetinteger- Number of results to skip, for pagination.default
0
synapsemcp_get_wiki_historyUse this when the user wants the revision history (edit log) of a specific Synapse wiki page — who changed it and when.Read-onlyGet Wiki History
Use this when the user wants the revision history (edit log) of a specific Synapse wiki page — who changed it and when. Owner entity ID example: syn123456. Wiki ID example: '123456' (numeric wiki page id). Paginate via offset if needed.
Inputs
owner_idstringrequired- The Synapse entity ID that owns the wiki (for example syn123456).
wiki_idstringrequired- The numeric wiki page ID. Omit for the root wiki page.
limitinteger- Maximum number of results to return.default
50 offsetinteger- Number of results to skip, for pagination.default
0
synapsemcp_get_wiki_order_hintUse this when the user wants to know the display order of sub-pages in a Synapse wiki — how the wiki navigation is sorted.Read-onlyGet Wiki Order Hint
Use this when the user wants to know the display order of sub-pages in a Synapse wiki — how the wiki navigation is sorted. Owner entity ID example: syn123456.
Inputs
owner_idstringrequired- The Synapse entity ID that owns the wiki (for example syn123456).
synapsemcp_get_wiki_pageUse this when the user wants to read a Synapse wiki page — its markdown content and metadata — attached to a project, folder, or file.Read-onlyGet Wiki Page
Use this when the user wants to read a Synapse wiki page — its markdown content and metadata — attached to a project, folder, or file. A Synapse wiki is the markdown documentation surfaced on an entity. Owner entity ID example: syn123456. Omit wiki_id to get the root wiki page.
Inputs
owner_idstringrequired- The Synapse entity ID that owns the wiki (for example syn123456).
wiki_idstring- The numeric wiki page ID. Omit for the root wiki page.
synapsemcp_list_curation_tasksUse this when the user wants every Synapse curation task in a project — the queue of data-curation work items attached to that project.Read-onlyList Curation Tasks
Use this when the user wants every Synapse curation task in a project — the queue of data-curation work items attached to that project. Project entity ID example: syn123456.
Inputs
project_idstringrequired- The Synapse project entity ID.
synapsemcp_list_entity_aclUse this when the user wants every ACL on a Synapse entity and, with recursive=True, on all its descendants — useful for auditing sharing recursively across a project subtree.Read-onlyList Entity ACL
Use this when the user wants every ACL on a Synapse entity and, with recursive=True, on all its descendants — useful for auditing sharing recursively across a project subtree. Set include_container_content=True to include files and folders inside containers; recursive=True requires include_container_content=True and walks into child containers as well. Entity ID example: syn123456.
Inputs
entity_idstringrequired- The Synapse entity ID (for example syn123456).
include_container_contentboolean- Whether to include files and folders inside containers.default
false recursiveboolean- Whether to include ACLs of all descendant entities as well.default
false target_entity_typesarray- Filter to only these entity types.
synapsemcp_list_evaluation_submission_bundlesUse this when the user wants Synapse submission plus scoring status together (as bundles) for an Evaluation queue — one call returns both sides.Read-onlyList Evaluation Submission Bundles
Use this when the user wants Synapse submission plus scoring status together (as bundles) for an Evaluation queue — one call returns both sides. Pass an increased ``offset`` to fetch the next batch. Evaluation ID example: '9600001'.
Inputs
evaluation_idstringrequired- The Synapse Evaluation (challenge queue) ID.
limitinteger- Maximum number of results to return.default
50 offsetinteger- Number of results to skip, for pagination.default
0 statusstring- Filter results to this status value.
synapsemcp_list_evaluation_submissionsUse this when the user wants ALL submissions (every challenge entry from every participant) sent to a Synapse Evaluation queue — optionally filtered by status (SCORED, INVALID, etc.).Read-onlyList Evaluation Submissions
Use this when the user wants ALL submissions (every challenge entry from every participant) sent to a Synapse Evaluation queue — optionally filtered by status (SCORED, INVALID, etc.). NOT just the caller's own — use list_my_submissions for that. Pages through the queue's submission list; pass an increased ``offset`` to fetch the next batch. Evaluation ID example: '9600001'. Returns raw Submission objects; use list_submission_statuses for status-only data and list_evaluation_submission_bundles for bundled submission+status pairs.
Inputs
evaluation_idstringrequired- The Synapse Evaluation (challenge queue) ID.
limitinteger- Maximum number of results to return.default
50 offsetinteger- Number of results to skip, for pagination.default
0 statusstring- Filter results to this status value.
synapsemcp_list_evaluationsUse this when the user wants to enumerate Synapse Evaluation queues (challenges, competitions, leaderboards) — optionally filtered by project, access type, or active-only.Read-onlyList Evaluations
Use this when the user wants to enumerate Synapse Evaluation queues (challenges, competitions, leaderboards) — optionally filtered by project, access type, or active-only. Project ID example: syn123456. Paginate via offset.
Inputs
access_typestring- Filter to evaluations the caller has this access type on.
active_onlyboolean- Only return currently active evaluations.
available_onlyboolean- Only return evaluations the caller can currently submit to.default
false evaluation_idsarray- Filter to this specific list of Evaluation IDs.
limitinteger- Maximum number of results to return.default
20 offsetinteger- Number of results to skip, for pagination.default
0 project_idstring- The Synapse project entity ID.
synapsemcp_list_form_dataUse this when the user wants the form submissions for a Synapse FormGroup — a collection of structured-data forms submitted by users.Read-onlyList Form Data
Use this when the user wants the form submissions for a Synapse FormGroup — a collection of structured-data forms submitted by users. Optionally filter by state (valid filter_by_state values: 'waiting_for_submission', 'submitted_waiting_for_review', 'accepted', 'rejected'). When as_reviewer=True the caller lists submissions they can review ('waiting_for_submission' is not allowed in this mode); when False (default) lists submissions the caller owns. Token-paginated: response includes ``next_page_token``; pass it back to fetch the next page (null on final page). Form group ID example: '42'.
Inputs
group_idstringrequired- The Synapse FormGroup ID.
as_reviewerboolean- List submissions the caller can review instead of submissions they own.default
false filter_by_statearray- Filter to these submission states (e.g. accepted, rejected).
next_page_tokenstring- Pagination token returned by a previous call. Omit for the first page.
synapsemcp_list_json_schema_versionsUse this when the user wants every version published for a Synapse JSON Schema.Read-onlyList JSON Schema Versions
Use this when the user wants every version published for a Synapse JSON Schema. Token-paginated like list_json_schemas: pass the returned ``next_page_token`` back to fetch the next page. Organization name example: 'org.sagebionetworks'. Schema name example: 'myDataset-1.0.0'.
Inputs
organization_namestringrequired- The Synapse JSON Schema organization name.
schema_namestringrequired- The Synapse JSON Schema name.
next_page_tokenstring- Pagination token returned by a previous call. Omit for the first page.
synapsemcp_list_json_schemasUse this when the user wants every Synapse JSON Schema (data model, validation contract) owned by an organization.Read-onlyList JSON Schemas
Use this when the user wants every Synapse JSON Schema (data model, validation contract) owned by an organization. Token-paginated (no limit/offset): the response includes ``next_page_token``; pass it back as the next call's ``next_page_token`` argument to fetch the following page. ``next_page_token`` is null on the final page. Organization name example: 'org.sagebionetworks'.
Inputs
organization_namestringrequired- The Synapse JSON Schema organization name.
next_page_tokenstring- Pagination token returned by a previous call. Omit for the first page.
synapsemcp_list_my_submission_bundlesUse this when the user wants their own Synapse submission+status bundles for an Evaluation queue — one call returns both submission and scoring status for every entry they made.Read-onlyList My Submission Bundles
Use this when the user wants their own Synapse submission+status bundles for an Evaluation queue — one call returns both submission and scoring status for every entry they made. Pass an increased ``offset`` to fetch the next batch. Evaluation ID example: '9600001'.
Inputs
evaluation_idstringrequired- The Synapse Evaluation (challenge queue) ID.
limitinteger- Maximum number of results to return.default
50 offsetinteger- Number of results to skip, for pagination.default
0
synapsemcp_list_my_submissionsUse this when the user wants their own submissions (challenge entries) to a Synapse Evaluation queue.Read-onlyList My Submissions
Use this when the user wants their own submissions (challenge entries) to a Synapse Evaluation queue. Pass an increased ``offset`` to page beyond the first batch. Evaluation ID example: '9600001'.
Inputs
evaluation_idstringrequired- The Synapse Evaluation (challenge queue) ID.
limitinteger- Maximum number of results to return.default
50 offsetinteger- Number of results to skip, for pagination.default
0
synapsemcp_list_submission_statusesUse this when the user wants the scoring statuses of every Synapse submission in an Evaluation queue — optionally filtered (SCORED, INVALID, etc.).Read-onlyList Submission Statuses
Use this when the user wants the scoring statuses of every Synapse submission in an Evaluation queue — optionally filtered (SCORED, INVALID, etc.). Evaluation ID example: '9600001'. Returns status records only; use list_evaluation_submissions for the submissions themselves.
Inputs
evaluation_idstringrequired- The Synapse Evaluation (challenge queue) ID.
limitinteger- Maximum number of results to return.default
10 offsetinteger- Number of results to skip, for pagination.default
0 statusstring- Filter results to this status value.
synapsemcp_search_entities_by_md5Use this when the user has an MD5 hash of a file and wants the Synapse entities (file entities) whose attached file has that exact MD5 — useful for deduplication and 'is this already in Synapse' checks.Read-onlySearch Entities By MD5
Use this when the user has an MD5 hash of a file and wants the Synapse entities (file entities) whose attached file has that exact MD5 — useful for deduplication and 'is this already in Synapse' checks. MD5 example: '9e107d9d372bb6826bd81d3542a419d6'.
Inputs
md5stringrequired- The MD5 hash of the file content to search for.
synapsemcp_search_entity_by_nameUse this when the user has a file name or Synapse entity name (and optionally its parent folder or project) but does not know the Synapse ID — resolves an exact name to its Synapse ID.Read-onlySearch Entity By Name
Use this when the user has a file name or Synapse entity name (and optionally its parent folder or project) but does not know the Synapse ID — resolves an exact name to its Synapse ID. The name match is case-sensitive (e.g. 'Patient Record Set' will not match 'Patient record set'); use search_synapse for fuzzy or case-insensitive lookup. Parent entity ID example: syn123456. Name example: 'sample.csv'.
Inputs
namestringrequired- The exact entity name to resolve to a Synapse ID.
parent_idstring- Restrict to entities under this parent container ID.
synapsemcp_search_synapseSearch Synapse entities using keyword queries with optional name/type/parent filters.Read-onlySearch Synapse
Search Synapse entities using keyword queries with optional name/type/parent filters. Results are served by Synapse as data custodian. Attribution and licensing are determined by the original contributors; check the specific entity's annotations or Wiki for details.
Inputs
entity_typestring- Filter results to a single entity type (for example file, folder, project, table).
entity_typesarray- Filter results to multiple entity types. Pass as a JSON array of strings via the SDK, not as a string.
limitinteger- Maximum number of results to return.default
20 namestring- Filter results to entities matching this exact name.
offsetinteger- Number of results to skip, for pagination.default
0 parent_idstring- Restrict the search to entities under this parent container ID (for example syn123456).
query_termstring- Free-text keyword query to search Synapse entities.
No tools match.
